我的世界 Java 版服务器卡死不崩怎么办?Watchdog、线程转储与主线程阻塞

服务器进程还在、端口也在,但所有玩家都动不了,这通常不是网络问题,而是主线程被卡住了。

先给结论

Java 版服务端的大部分游戏逻辑运行在主线程。插件在主线程执行耗时操作、死循环、数据库等待或世界操作异常时,服务器会表现为整体卡死。Paper 等服务端提供 Watchdog 机制,会在主线程长时间无响应时输出线程信息;管理员也可以使用 Java 工具获取线程转储。排查重点是找出主线程卡在什么位置,再定位插件、配置或数据问题。

一、卡死与崩溃不同

崩溃通常意味着进程退出或生成崩溃报告;卡死则是进程仍在运行,但游戏逻辑停止推进。

玩家表现为无法移动、命令无响应、聊天延迟,最后可能超时断开。

服务器 CPU 可能很高,也可能很低,取决于主线程是在计算还是在等待。

卡死时不要立刻强制结束进程,先尽量收集线程信息。

明确是卡死而不是网络断开,能避免在错误方向上排查。

二、Watchdog 能提供什么

部分服务端核心会监控主线程是否长时间没有完成游戏刻。

超过阈值时,会在日志中输出线程堆栈,显示主线程当前正在执行的方法。

这些信息对定位插件阻塞非常关键,因为它直接说明卡在哪里。

Watchdog 输出可能出现在 latest.log 中,崩溃或重启后要及时保存。

不同服务端核心的阈值与输出格式可能不同,要以实际版本为准。

三、手动获取线程转储

如果没有 Watchdog 输出,可以使用 Java 自带工具获取线程转储,例如 jstack 或 jcmd。

需要先找到服务端 Java 进程的 PID,并使用有权限的账户执行。

线程转储会列出所有线程及其当前堆栈,重点查看服务器主线程。

连续间隔几秒获取多次转储,能判断主线程是否一直卡在同一位置。

线程转储文件要与卡死时间、日志一起保存。

四、怎么分析主线程

先找到名称类似 Server thread 的主线程。

查看其堆栈顶部附近的方法,如果出现插件包名,通常说明插件代码正在主线程执行。

如果主线程在等待锁、网络或数据库,说明某项同步操作阻塞了游戏逻辑。

如果主线程在大量处理区块、实体或方块更新,说明可能是世界负载突增。

多次转储都卡在同一插件方法时,基本可以锁定嫌疑对象。

五、常见原因

插件在主线程执行数据库查询、网络请求或大量文件读写。

插件逻辑出现死循环或递归,主线程无法返回。

世界中出现异常实体或区块数据,导致处理时间异常长。

大型区域编辑、回滚或预生成任务在高峰期执行。

内存不足导致长时间 GC,看起来像卡死。

六、处理与预防

确认嫌疑插件后,在测试环境复现,并联系插件作者或寻找配置项。

高风险插件应避免在主线程执行耗时操作,尤其是数据库和网络请求。

大型编辑、回滚和预生成安排在低峰并分批执行。

保持性能分析工具可用,卡顿早期就能发现趋势。

把卡死案例写入运维记录,包括线程转储位置、根因和修复方式。

七、常见问题

有人问卡死时能否直接重启。可以止损,但最好先获取线程信息,否则根因可能无法确认。

还有人问 CPU 不高为什么也卡死。主线程可能在等待锁、网络或数据库。

也有人看到很多线程不知道看哪个。优先看服务器主线程。

最后一个常见问题是卡死后数据异常。先保留现场,再从备份或副本中排查。

执行步骤

  1. 确认问题是卡死而非网络断开。
  2. 保存 latest.log 中的 Watchdog 输出。
  3. 找到服务端 Java 进程 PID。
  4. 使用 jstack 或 jcmd 间隔多次获取线程转储。
  5. 定位服务器主线程并查看堆栈顶部。
  6. 判断是插件阻塞、等待、世界负载还是 GC。
  7. 在测试环境复现并验证修复。
  8. 记录卡死时间、线程转储和根因。

验收标准

  • 已区分卡死与网络问题。
  • 保存了 Watchdog 或线程转储信息。
  • 找到了主线程卡住的位置。
  • 嫌疑插件或数据区域已确认。
  • 修复在测试环境验证。
  • 案例已写入运维记录。

常见误区

  • 卡死后直接强制结束进程。
  • 没有保存 Watchdog 输出。
  • 只获取一次线程转储。
  • 忽略主线程,盯着无关线程。
  • 在主线程运行数据库或网络操作。
  • 高峰期执行大型编辑或回滚。

服务器卡死时,主线程堆栈就是最关键的证据。先拿到 Watchdog 或线程转储,再锁定阻塞位置,卡死问题才能被真正修复而不是靠重启掩盖。