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

Aperta
  • Qualcosa non va?
#7,154 1 commento 2 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
Mezza giornata
Idoneità per principianti
70/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
java
Ambito
desktop

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Java
Stelle
10.9k
Fork
1.3k
Merge medio
12h 10m
PR unite (30g)
96

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di HMCL-dev/HMCL

Tutte le issue di HMCL-dev/HMCL

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.