HMCL打不开或闪退？按症状排查
游戏非正常退出、Java 报错、内存不足、白屏闪退等问题，可按下方的症状分类定位原因，再进入对应子页按步骤处理。
毒霸安全检测MD5公开可验证无恶意广告弹窗
先按症状选择排查路径
- 提示 UnsupportedClassVersionError 或 Java 版本不匹配
高版本 Java 无法运行旧版 Forge，或游戏版本要求的 Java 与当前不符。查看 Java 版本对照与切换 → - 提示 OutOfMemoryError 或游戏运行几分钟后崩溃
多为内存分配不足或模组占用过高。查看内存与 JVM 参数设置 → - 安装 Forge/Fabric 后启动即崩溃
多为加载器版本与游戏版本不匹配，或模组冲突。查看加载器安装与冲突排查 → - 画面白屏/黑屏但声音正常
多为多显卡驱动兼容或渲染模式问题，可尝试无边框窗口。查看显卡设置 → - 微软账号登录转圈/白屏/报错
多与国内连接微软认证服务器不畅有关。查看微软登录排障 → - 局域网联机搜不到房间
多与防火墙拦截或网络适配器配置有关。查看联机排障 →
常见报错与对应处理
| 常见报错特征 | 核心原因 | 解决方法 |
|---|---|---|
| java.lang.UnsupportedClassVersionError | Java 版本与游戏要求不符 | 切换到游戏版本对应的 Java 8/17/21。详见 Java 版本对照。 |
| java.lang.OutOfMemoryError | 分配内存超过上限或模组过多 | 按物理内存约 1/3 分配，并调整 JVM 参数。 |
| NullPointerException (含某模组名.jar) | Mod 损坏、缺失依赖或版本冲突 | 在模组管理中临时禁用该 Mod，并更新前置 API。 |
| msvcp140.dll / vcruntime140.dll 缺失 | 系统缺少 VC++ 运行库 | 安装微软 VC++ 运行库（Visual C++ Redistributable）。 |
常见故障深度处理
按症状选择对应子页，获得可执行的排查步骤。
Java版本不匹配与崩溃修复
各游戏版本对 Java 有明确要求（1.12.2 用 Java 8、1.18+ 用 Java 17）。提供版本对照与切换步骤。
查看 Java 兼容对照 →内存分配与 JVM 参数优化
内存分配过高或过低都会引起卡顿。提供分配建议、垃圾回收参数说明与显卡设置。
查看内存优化 →常见问题
为什么游戏启动后，屏幕中间白屏/黑屏，声音正常但点不了？
这是由于游戏默认的窗口渲染模式与您的电脑多显卡（Intel/AMD 核显 + NVIDIA 独显）驱动兼容冲突导致。建议在 HMCL 游戏设置中，开启“使用无边框窗口模式运行”，并将 Java 程序的显卡首选项强制指引为“高性能 NVIDIA 显卡”。
安装 Forge 之后，点击启动游戏就弹崩溃，用纯净版就能进？
这代表您安装的 Forge 版本与您的 Minecraft 版本存在细微不匹配，或您放入的 Mod 有严重的冲突、或者是 Forge 框架未下载完整。建议在 HMCL 中使用“模组管理” -> “重装游戏核心”功能，让启动器自动清空并重新自动下载全套 Forge 编译链。
点击下载 Java 总是提示“校验失败”或“获取文件失败”？
这是网络在传输二进制大包时发生的丢包现象。请确保杀毒软件没有在后台偷偷切断下载器的连接。同时，建议临时关闭您的代理软件或 VPN，让 HMCL 直接向国内公开可信的 BMCLAPI 骨干 CDN 镜像站拉取 OpenJDK 运行库。