先给结论
基岩版连接失败的信息往往很模糊,必须靠分层排除:先确认客户端和服务端版本兼容,再确认准入配置,最后才怀疑网络。每一层都留下可对比的证据。
执行步骤
- 核对客户端版本与服务端版本是否兼容,确认玩家使用的是同一条版本线,而不是测试版与服务端混用。
- 检查 allow-list 与 permissions.json 是否包含该玩家的 XUID,确认没有被误删或填错。
- 确认 server-port 与 server-portv6 正确、防火墙放行 UDP、外网入口可达,并用不同网络环境交叉测试。
- 若以上都正常,再看服务端日志是否有被踢出、超时或包校验失败的记录,据此判断是准入还是网络问题。
验收标准
- 能用具体错误信息区分版本问题、权限问题和网络问题。
- 同一账号在内网和外网的表现差异被记录,便于定位 NAT 或运营商问题。
- 修复后让原本失败的玩家重新测试,而不只是本机管理员自己进入成功。
常见误区
- 让新人反复重装客户端,却没有核对服务端版本和端口。
- 只测试本机局域网连接,就断定外网配置没有问题。
建议先在测试服或测试存档验证,再切换到正式服;涉及升级、迁移和网络调整时先保留可回退副本。