☰

理解 Minecraft 日志

当出现问题时，Minecraft 日志是你最可靠的真相来源。它们按顺序记录了游戏或服务器的行为，一直到故障发生的那一刻。本指南将解释哪些日志文件重要、如何阅读一行日志，以及要寻找什么。

重要的日志文件

一切都在 logs/ 文件夹中（服务器根目录，或客户端上的 instance/.minecraft）：

  • latest.log
    当前运行的完整日志。这是你最先打开的文件；错误几乎总是在这里。
  • debug.log
    同一次运行的详细得多的版本。当 latest.log 说得不够时使用它。
  • 归档日志
    较旧的运行被压缩为 2026-06-08-1.log.gz. 解压它以阅读过去的会话。
  • crash-reports/
    一个单独的文件夹，包含一份聚焦的报告，仅在游戏崩溃时写入。请见 如何阅读 Minecraft 崩溃报告.

如何阅读一行日志

每一行都遵循相同的格式：

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    时间戳：事件发生的时间。
  • [Server thread/ERROR]
    记录它的线程，以及级别。
  • 消息
    实际发生了什么，如果是错误，通常后面会跟着堆栈跟踪。

日志级别让你一眼看出严重程度： INFO (正常), WARN (出了点问题但不致命), ERROR (真正的故障), 和 FATAL (服务器正在关闭).

线程：谁在说话

  • Server thread / main
    核心游戏循环。这里的错误通常直接影响游戏玩法（并可能使服务器崩溃）。
  • Worker / IO threads
    后台工作，例如区块 I/O。对磁盘和世界保存问题很有用。
  • Mod/plugin threads
    以某个模组或插件命名：快速提示是什么在负责。

要寻找什么

  1. 滚动到第一行 ERROR/FATAL 或 Exception；后面的错误通常只是它的后果。
  2. 阅读启动部分，查看失败的模组/插件、错误的 Java 版本或未接受的 EULA。
  3. 留意重复的 WARN 刷屏，例如“Can't keep up!”（性能，请见 Can't Keep Up) 或“moved too quickly”。
  4. 记下冻结或关闭前的最后几行：它们显示服务器宕机时正在做什么。
  5. 将任何错误与 常见问题 列表交叉对照以获得确切的解决方案。

服务器日志与客户端日志

它们格式相同，但位于不同位置。服务器日志记录世界保存、玩家连接和插件/模组加载；客户端日志记录渲染、资源包和你自己的连接。排查加入问题时，请比较两者：原因可能只在其中一侧。

安全地分享日志

日志可能包含你的服务器 IP，偶尔还有令牌，所以不要在未先查看的情况下公开粘贴它们。使用粘贴服务（例如 mclo.gs）来分享，或将文件直接上传到 MCDoctor.ai，它会读取日志并为你解释原因和解决方案，无需手动翻查。

常见问题

在你服务器根目录的 logs/ 文件夹或 instance/.minecraft 文件夹中。当前运行为 latest.log；较旧的运行为压缩的 .log.gz 文件。

它们涵盖同一次运行，但 debug.log 详细得多。先从 latest.log 开始，仅在需要更多细节时才切换到 debug.log。

WARN 表示有问题但不致命；ERROR 是真正的故障；FATAL 表示服务器正在关闭。请关注第一行 ERROR/FATAL。

可以，上传 latest.log 或崩溃报告，MCDoctor.ai 会进行分析并返回可能的原因和推荐的修复方法。

分析我的日志