Minecraft Java服务器提示Failed to verify username，说明玩家身份验证链没有完成。先判断是单个玩家还是所有玩家都失败：单人故障优先检查客户端登录会话；全服故障则检查官方验证服务状态、服务器时间、DNS、出站HTTPS和代理转发配置。不要把online-mode改成false当作通用修复。
先用影响范围缩小故障层
| 现象 | 优先检查 | 不要先做 |
|---|---|---|
| 只有一名玩家失败 | 启动器会话、账号登录、客户端版本 | 修改全服认证设置 |
| 所有正版玩家同时失败 | 验证服务状态、服务器出站网络、DNS和时间 | 重装地图或删除玩家数据 |
| 直连正常，经过Velocity等代理失败 | 代理转发模式、密钥、后端隔离 | 把后端端口直接开放公网 |
| 重启或更新后才出现 | 配置是否被覆盖、容器环境变量、服务端版本 | 连续切换多个未知参数 |
把客户端提示时间与服务端logs/latest.log对齐。相近的提示还包括Invalid session、无法连接验证服务器或认证超时，它们指向的层次可能不同，不能只看玩家端的一行文字。
只有一名玩家失败：刷新客户端登录会话
让玩家完全退出游戏和启动器，再在官方启动器中退出账号并重新登录，确认当前选择的是拥有Java版授权的同一Microsoft账号。若其他正版玩家能正常进入，服务器端大范围故障的概率较低。
不要让玩家删除世界、角色数据或随意修改用户名。身份验证发生在加入服务器之前，删除存档通常无助于解决会话令牌问题，还可能造成不可恢复的数据损失。
所有玩家失败：检查服务器时间、DNS和出站连接
timedatectl status
getent hosts sessionserver.mojang.com
curl -I --max-time 10 https://sessionserver.mojang.com/
grep -Ei 'verify username|session|authentication|timed out|unknown host' logs/latest.log | tail -n 80访问根地址可能返回非200状态，排查重点是DNS能否解析、TLS能否建立、是否明显超时或被拦截。系统时间偏差会影响TLS和令牌校验；DNS错误、出站443端口限制、错误代理环境变量或上游网络故障，也会让服务器无法联系验证服务。
如果所有服务器在同一时间出现问题，先查看Minecraft官方服务状态和当前社区故障信息，再决定是否改配置。外部服务短暂异常时，保留online-mode=true并等待恢复，通常比降低认证安全更稳妥。
核对server.properties中的online-mode
grep -E '^(online-mode|server-port|server-ip)=' server.propertiesPaper官方配置参考中，独立服务器的online-mode默认值为true。该模式会验证玩家身份并取得对应资料。对直接面向玩家的独立服务器，应保持开启。
把它改成false会允许未经官方验证的名称进入；在没有额外身份保护时，攻击者可能冒用其他玩家名称或管理员身份。白名单也不能完全替代正版身份验证，因为白名单依赖的名称本身可能被冒用。
修改server.properties后需要完整重启服务端才能生效。如果使用容器镜像或游戏面板，还要检查ONLINE_MODE一类环境变量是否在启动时重写文件，避免“文件改了但重启后恢复原值”。
使用Velocity或其他代理时，认证位置会变化
代理架构中通常由前置代理完成玩家认证，后端Paper服务器接收经过验证和转发的玩家信息。此时不能只改一个online-mode参数：代理的在线认证、Paper当前版本支持的玩家信息转发模式、共享密钥和后端网络隔离必须成套配置。
- 前置代理应按官方文档启用正版认证。
- Paper后端使用与当前版本匹配的安全转发方式，密钥必须一致。
- 后端游戏端口只允许代理服务器访问，不能直接暴露给公网玩家。
- 代理和后端升级后重新核对配置字段，旧教程的键名可能已经变化。
如果直连后端能进入、经过代理却失败，重点查转发配置；如果代理正常、后端端口又能被公网直连，则存在绕过前置认证的风险，应先修复网络隔离。
版本、启动目录和配置覆盖也会制造假象
server.properties位于服务端当前工作目录。systemd、面板或Docker若从另一个目录启动，管理员可能编辑了错误文件。先从启动命令确认工作目录，再核对日志中的服务端版本、配置加载和监听端口。
Paper、Velocity、插件和客户端版本不匹配时，日志通常会出现更具体的协议或转发错误。不要只保留玩家端截图，应保存服务端启动日志和首次失败附近的完整上下文。
恢复验证不要只测一次
- 保留
online-mode=true的独立服务器先由一名正版玩家重新登录测试。 - 再用另一名正版玩家验证，排除单一账号会话问题。
- 确认服务端日志不再出现验证超时、未知主机或转发密钥错误。
- 代理架构检查后端端口无法被公网直连，只能由代理访问。
- 重启服务端后再测一次，确认配置不会被面板或容器环境变量覆盖。
需要重新核对Java版原版与Paper的基础部署，可阅读Minecraft Java版开服教程；选择VPS时则可参考游戏开服VPS配置方法，但配置规格不能替代认证链排错。
云服务器与游戏云信息
极跃圈收录的雨云信息页覆盖云服务器和游戏云，当前记录的邀请码为admin01。实际折扣、适用产品、期限和新购续费规则请以当前结算页面与服务条款为准；购买更高配置不会自动解决验证服务、DNS或代理转发错误。
常见问题
把online-mode改成false就能马上进服吗？
可能绕过官方身份验证，但会带来名称冒用和绕过认证的风险，不应作为独立公网服务器的常规修复。代理架构也必须配合安全转发和后端隔离，不能只改这一项。
只有一个玩家提示Failed to verify username怎么办？
优先让该玩家完全退出游戏和官方启动器，重新登录拥有Java版授权的账号，并确认客户端版本。其他玩家正常时，先不要修改全服配置。
所有玩家突然都无法验证是什么原因？
常见方向是官方验证服务异常、服务器时间错误、DNS解析失败、出站HTTPS被阻断，或代理转发配置失效。用日志和服务器侧网络检查逐层确认。
修改server.properties后需要重启吗？
需要。服务端会在启动时读取该文件；容器或面板环境还要确认启动参数和环境变量没有覆盖修改。
