HMCL 启动失败排查：Java、内存与模组冲突
闪退、黑屏、卡在加载界面？按这份清单从 Java 版本一路排查到崩溃日志分析。
排查顺序：先分清是「启动器打不开」还是「游戏起不来」
这两类问题的方向完全不同：
- 启动器本身无法打开：多与 Java 环境、杀毒拦截、文件损坏有关
- 启动器能打开但游戏启动失败：多与 Java 版本、Mod 冲突、内存设置有关
一、启动器无法打开
1. 确认已安装 Java 8 及以上（.jar 包必需；.exe 内置启动入口但同样依赖 Java）。
2. 把 HMCL 所在目录加入杀毒软件白名单——先校验 SHA-256 确认文件可信。
3. 检查文件是否被系统标记为「来自 Internet」，右键属性中解除锁定。
二、游戏闪退或黑屏
- Java 版本：1.17 及以上必须用 Java 17+，1.16 及以下用 Java 8。
- 内存不足：内存过小会直接闪退，过大也会因 GC 压力卡顿，建议 4 GB 机器分配 2 GB。
- Mod 冲突：移出 mods 文件夹后单独启动纯净版本，逐一加回定位冲突项。
- 显卡驱动：更新显卡驱动，或尝试关闭光影。
三、读懂崩溃日志
开启版本隔离后，崩溃日志位于该版本工作目录下的 crash-reports 文件夹。重点看两处：
Description：一行概括崩溃原因Caused by：真正的触发点，通常能直接看到某个 Mod 的名字
把这两段贴到社区提问，比贴整份日志有效得多。
四、还是不行？
在 HMCL 的启动器设置中调高日志等级后复现问题，把完整日志保存下来。日志里的 Java 路径、JVM 参数和加载顺序是定位问题的关键信息，也可以前往 HMCL 文档中心（docs.hmcl.net）查阅对应章节。