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

Abierto
  • ¿Algo no está bien?
#7,154 1 comentario 2 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
Medio día
Aptitud para principiantes
70/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
java
Área
desktop

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
Java
Estrellas
10.9k
Forks
1.3k
Merge medio
14 h 50 min
PR fusionados (30 d)
103

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de HMCL-dev/HMCL

Todos los issues de HMCL-dev/HMCL

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.