无法连接 Minecraft Java 服务器的排查顺序

“连接不上”不是单一故障。连接被拒绝、超时、未知主机、版本过旧、认证失败和模组握手错误分别属于不同层。先记录错误，再从服务器向外排查；一上来关闭所有防火墙或重装游戏，通常只会增加变量和风险。

保存完整错误和测试范围

记录客户端原文、发生时间、地址与端口、Java 版本、启动器配置、加载器和模组包。询问是所有人都连不上，还是只有一个玩家；服主能否本机连接，面板是否显示完整启动。把同一时间的服务端日志保存下来。

公开求助时不要发送面板密码、API 密钥、私网详情或包含凭据的完整日志。保留错误和时间，敏感值应打码。

确认服务端真正进入监听状态

从进程启动第一行读到正常就绪消息。面板亮绿灯不代表 Java 已完成启动；缺少模组、端口占用、EULA、世界损坏或内存不足都可能在监听前让进程退出。若进程崩溃，先修复最早的启动错误。

进程在线时，核对监听端口和 server-ip。Paper 文档通常建议没有特殊网络需求时把 server-ip 留空。连续点击重启只会得到多份不完整日志。

对齐 Java 版本与必要内容

标准 Java 服务器需要 Java 客户端；基岩版不能仅凭同一 IP 直接加入。确认玩家打开的是 Minecraft: Java Edition。客户端和服务端协议版本需兼容，“客户端过旧”或“服务器过旧”是版本问题，不是防火墙问题。

模组服还要匹配加载器、模组包版本及必要模组。优先和一名能正常进入的玩家比较完整启动配置，不要随机逐个添加文件。排查时使用稳定版本，Snapshot 或协议兼容插件会增加额外变量。

核对地址、端口和 DNS

从主机当前连接页复制地址，去掉 https://、网页路径和多余空格。非默认端口必须写成 example.net:25570。未知主机通常指向拼写或 DNS；连接被拒绝常见于服务器未监听、端口错误、绑定或规则拒绝；超时则更像路径中请求或响应被丢弃。

192.168.x.x 等私网地址通常只在局域网内有效。自建服要让公网访问，必须明确配置路由与防火墙，且要理解开放端口带来的攻击面。

按“谁能连接”分支定位

所有人都失败：优先检查启动、地址、端口、主机状态和监听。局域网能进而公网不能：检查端口转发、公网 IP、运营商 CGNAT、防火墙或主机分配。大多数人能进但某一人失败：检查该玩家版本、账号、DNS、本地网络、安全软件和模组包。

若客户端已到达服务器却被踢出，日志通常会出现认证、白名单、封禁、重复登录或模组握手原因。同一时间完全没有连接记录，说明请求可能根本没有到达这个 Java 进程。

检查账号与多人权限

确认玩家登录了正确 Microsoft 账号，家庭或隐私设置允许多人游戏。会话过期可尝试正规退出再登录，但任何人都不应索要验证码或密码。白名单应核对当前 Java 用户名，同时检查封禁、OP 和认证服务状态。

如果多人同时突然认证失败，应先查看官方服务状态，再决定是否更改服务器配置。不要为了临时绕过故障长期关闭正版验证。

只放行必要的网络规则

确认进程和端口后，才检查系统、防火墙、路由器或主机安全组。仅允许 Java 服务或指定 TCP 端口及正确网络配置，不要永久关闭系统防火墙、杀毒软件、路由保护或身份认证。

家庭网络需把外部端口转发到当前服务器内网地址；若运营商使用 CGNAT，普通端口转发可能无效，应咨询运营商或使用可信主机，而不是不断扩大开放范围。更换手机热点可作为对比测试，但不应变成长期旁路。

带证据向主机商升级

仍无法解决时，整理客户端错误、时间和时区、受影响用户范围、本地与公网测试结果、服务端版本和核心、地址类型、完整启动片段及失败连接对应日志。这样主机商才能直接检查端口分配和路由。

最有效的顺序是：错误原文、完整启动、Java 与版本、地址端口、影响范围、账号拒绝，最后才是窄范围网络规则。它既减少停机，也避免把普通连接故障变成安全漏洞。