先给结论
Java 版服务端崩溃时,通常会在 crash-reports 目录生成崩溃报告,同时 logs 目录中的 latest.log 记录了崩溃前后的运行过程。排查要按顺序进行:先保存现场,再读崩溃报告的描述与异常类型,然后查看堆栈中第一个属于插件或模组的位置,最后结合日志时间线和近期变更判断根因,并在测试环境复现验证。
一、先保存现场
服务器崩溃后,先复制 crash-reports 中最新的报告和 logs 目录中的 latest.log。
如果服务端会自动重启,旧的 latest.log 可能被压缩归档或覆盖,要及时保存。
同时记录崩溃时间、在线人数、正在进行的活动和最近的配置变更。
如果怀疑世界数据受损,先复制世界目录,后续操作都在副本上进行。
现场保存完整,后续排查才有依据。
二、崩溃报告的结构
崩溃报告开头通常包含描述,说明崩溃发生在什么阶段,例如处理实体、加载区块或执行任务。
接着是异常类型和堆栈信息,它显示程序在崩溃时正在执行哪些方法。
报告后部通常包含系统信息、Java 版本、内存、服务端版本和已加载插件或模组列表。
不同服务端核心和模组加载器的报告格式会有差异,但核心信息大致相同。
先看描述和异常类型,再看堆栈,不要一开始就从最后一行开始猜。
三、如何读堆栈
堆栈从上到下展示方法调用链,靠前的位置通常更接近直接出错的代码。
查找第一个属于插件包名或模组包名的行,它往往指向问题来源。
如果堆栈全部是服务端核心代码,可能是世界数据异常、核心缺陷或某个插件间接触发。
同一个异常反复出现时,说明问题可以复现,排查价值更高。
把可疑插件或模组名称记录下来,再结合日志确认。
四、结合 latest.log 时间线
latest.log 能显示崩溃前发生了什么,例如插件报错、玩家执行命令、区块加载异常或内存警告。
崩溃前的大量重复警告通常比最后一条错误更有诊断价值。
查看启动阶段日志,确认是否有插件加载失败、依赖缺失或版本不兼容。
如果崩溃发生在特定玩家操作后,可以从日志中定位该玩家与时间点。
把崩溃报告和日志时间对齐,形成完整事件线。
五、常见崩溃类型
插件或模组版本不兼容,常见于服务端升级后。
内存不足,表现为内存溢出异常或长时间 GC 后崩溃。
世界数据异常,常与特定区块、实体或方块状态有关。
插件在主线程执行耗时操作,导致服务端长时间无响应并被守护机制处理。
配置错误,例如格式错误、无效值或依赖服务不可用。
六、复现与修复
在测试环境使用相同版本服务端、插件或模组和世界副本复现崩溃。
如果怀疑某个插件,先在测试环境移除或降级它,再观察是否仍会崩溃。
如果与特定区块有关,可以在测试世界中前往该区域复现。
修复后让测试环境运行足够时间,确认问题不是暂时消失。
正式修复时保留旧版本插件和配置,出现新问题可以回退。
七、常见问题
有人问没有生成崩溃报告怎么办。查看 latest.log 和系统层面的退出记录,进程可能被系统终止。
还有人问崩溃报告里插件很多,怎么判断是谁。优先看堆栈中第一个出现的插件或模组包名。
也有人删插件后不崩了。仍要确认根因,避免同类插件再次引发问题。
最后一个常见问题是升级后频繁崩溃。先核对插件与模组兼容版本。
执行步骤
- 保存最新崩溃报告、latest.log 和世界副本。
- 记录崩溃时间、在线人数和最近变更。
- 阅读崩溃描述与异常类型。
- 在堆栈中查找第一个插件或模组相关位置。
- 用 latest.log 对齐崩溃前后的事件时间线。
- 判断是否属于兼容、内存、世界数据、主线程阻塞或配置问题。
- 在测试环境复现并验证修复。
- 正式修复后记录根因与处理方式。
验收标准
- 崩溃现场已完整保存。
- 能说出崩溃描述与异常类型。
- 找到了可疑插件、模组或数据区域。
- 日志时间线与崩溃报告一致。
- 修复在测试环境验证通过。
- 排查结论已记录。
常见误区
- 崩溃后立即重启,日志被覆盖。
- 只看最后一行报错。
- 不看堆栈就随机删插件。
- 在正式服直接试改。
- 删除插件后不确认根因。
- 忽略最近的升级与配置变更。
崩溃报告是服务器留下的事故记录。保存现场、读描述、看堆栈、对齐日志、测试复现,崩溃排查就会从猜测变成定位。