[Bug] 日志窗口的「清空」会清掉崩溃导出里的 `minecraft.log`，导出的只剩一行合成退出码

未关闭
  • 哪里不对？
#7,154 1 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
半天
新手友好度
70/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
java
领域
desktop

调研方向

The shared list is logs in LauncherHelper.java, passed to LogWindow at about line 880. LogWindow.onClear() clears that same list, and GameCrashWindow.java (around lines 259-276) builds the export text from it, which LogExporter.java then writes as minecraft.log. Start by giving the export its own copy or separate buffer, so that clearing the window does not touch it. Done means the exported minecraft.log still contains the full output after the window's Clear button is pressed.

由索引模型根据 Issue 内容生成。

描述

bug
问题描述 | Bug Description

环境

  • HMCL 3.16.4（当前 main 上同样存在，见下方行号）
  • Windows 11 25H2 / Java 25 / 打开「显示游戏日志窗口」

现象

游戏正常启动后崩溃（Fabric 在 classTweaker 阶段抛错，exit code 1），从崩溃窗口导出崩溃信息，zip 中：

  • latest.log：完整，98 行 / 5330 字节，含完整异常栈（游戏 log4j 的 File appender 写入，符合预期）
  • minecraft.log：只有 93 字节一行：
[13:46:22] [HMCL ProcessListener] Minecraft exit with code 1(0x1), type is APPLICATION_ERROR.

两文件时间相差 48 秒（13:45:34 → 13:46:22），hmcl.log 在该区间没有任何异常或读取错误记录。导出的文件看起来像一次正常导出，很难发现中间的日志已经丢失。

期望

minecraft.log 是启动器捕获的控制台输出，应包含 latest.log 的内容（这正是它作为“崩溃前输出”的价值）。日志窗口 UI 上的「清空」不应影响导出数据源。

复现步骤

  1. 实例设置里打开「显示游戏日志窗口」（或用「测试游戏」，setTestMode() 会强制打开）
  2. 启动一个会崩溃的实例（启动期崩溃即可）
  3. 在游戏日志窗口点「清空」
  4. 崩溃后点「导出游戏崩溃信息」
  5. 检查 zip 里的 minecraft.log

结果：minecraft.log 只剩 onExit 合成的那行退出码，latest.log 依旧完整。

根因

HMCLProcessListener.logs 这一个 CircularArrayList 同时承担两个职责：日志窗口的显示缓冲、崩溃导出 minecraft.log 的唯一数据源。而窗口的「清空」按钮直接清的就是这个对象。

1) 捕获列表（唯一数据源）

HMCL/src/main/java/org/jackhuang/hmcl/game/LauncherHelper.java（main 8e1612784）：

private final CircularArrayList<Log> logs;
...
this.logs = new CircularArrayList<>(Log.getLogLines() + 1);
...
if (showLogs) {
    logWindow = new LogWindow(process, logs);   // 第 880 行：把同一个实例交给 UI
    logWindow.show();
}
2) 「清空」按钮直接清这个实例

HMCL/src/main/java/org/jackhuang/hmcl/ui/LogWindow.java（main，行号 189-192、417-418）：

private void onClear() {
    impl.listView.getItems().clear();
    logs.clear();          // ← 清掉的就是导出数据源
}

JFXButton clearButton = new JFXButton(i18n("button.clear"));
clearButton.setOnAction(e -> getSkinnable().onClear());
3) 导出时把这个列表拼成 minecraft.log

HMCL/src/main/java/org/jackhuang/hmcl/ui/GameCrashWindow.java（main，行号 259-276）：

return CompletableFuture.supplyAsync(() ->
                logs.stream().map(Log::getLog).collect(Collectors.joining("\n")))   // 第 263 行
        .thenComposeAsync(logs -> {
            ...
            return LogExporter.exportLogs(logFile, gameInstance, launchOptions, logs, ...); // 第 276 行
        })...

HMCL/src/main/java/org/jackhuang/hmcl/game/LogExporter.java（main，行号 64）：

zipper.putTextFile(logs, "minecraft.log");
4) 为什么导出只剩「一行退出码」

退出行是在 onExit 里、清空之后才追加的（main LauncherHelper.java:1013-1022）：

if (showLogs) {
    logBuffer.add(new Log(String.format("[%s] [HMCL ProcessListener] Minecraft exit with code %d(0x%x), type is %s.", ...)));
    submitLogThread.interrupt();
    submitLogThread.join();
}

清空后列表为空，最终只剩这一行合成内容，因此文件看起来还“像一个正常导出”，进一步掩盖了数据丢失。

启动器崩溃报告 / 启动器日志文件 | Launcher Crash Report / Launcher Log File

minecraft-exported-crash-info-2026-11-01T15-36-16.zip
minecraft-exported-crash-info-2026-11-01T13-46-24.zip

主要语言
Java
星标
10.9k
派生
1.3k
平均合并
11 小时 40 分钟
30 天内合并 PR
90

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

HMCL-dev/HMCL 的其他 Issue

查看 HMCL-dev/HMCL 的全部 Issue

相似的 Issue

更多 Java Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。