Minecraft 1.12.2模组开发：runClient任务执行失败求助

问题场景 #

使用IntelliJ IDEA Community Edition 2021.3开发Minecraft 1.12.2模组，构建成功，但执行runClient命令时触发错误：

任务':runClient'执行失败，提示进程'command 'C:\Users\NB\.jdks\semeru-1.8.0_382\bin\java.exe''以非零退出值-1结束。

系统提示可通过--stacktrace、--info/--debug、--scan获取更多信息。

排查与解决步骤 #

1. 先获取详细错误日志

默认提示信息不足以定位问题，先执行带参数命令拿到完整报错细节：

• 在IntelliJ终端执行：gradlew runClient --stacktrace，获取异常堆栈，定位具体报错代码或环节
• 若堆栈信息仍模糊，执行gradlew runClient --debug，查看全量调试日志，重点关注ERROR或Exception标记内容

2. 验证JDK兼容性

Minecraft 1.12.2强制要求Java 8，针对你当前使用的Semeru 1.8.0_382：

• 确认是64位JDK，32位Java运行MC模组极易出现内存溢出或兼容性问题
• 检查项目JDK配置：File > Project Structure > Project，确保SDK选中Semeru 1.8.0_382，语言级别设为8
• 可尝试更换Oracle JDK 8或Adoptium（原AdoptOpenJDK）的Java 8版本，部分OpenJDK衍生版存在兼容差异

3. 调整启动内存分配

内存不足是触发非零退出的常见原因，修改Gradle配置：

1. 打开项目根目录的build.gradle文件
2. 找到runClient配置块，添加或修改JVM内存参数：

   runClient {
       jvmArgs '-Xmx2G', '-Xms1G' // 最大堆内存2G、初始堆内存1G，可根据电脑配置调整
   }
   

3. 执行gradlew clean runClient，清理缓存后重新启动

4. 排查代码与依赖问题

• 检查近期新增的代码，尤其是方块/物品注册、事件监听逻辑，是否存在空指针、未初始化对象或语法错误
• 确认第三方依赖版本与Minecraft 1.12.2兼容，避免依赖冲突
• 执行gradlew clean build重新构建，留意构建过程中的隐藏警告或错误

5. 检查IntelliJ配置

• 确认Gradle插件版本符合Forge MDK要求：File > Settings > Build, Execution, Deployment > Build Tools > Gradle，Minecraft 1.12.2通常适配Gradle 3.x或4.x
• 刷新Gradle项目：点击右侧Gradle面板的刷新按钮，或执行gradlew --refresh-dependencies重新加载依赖

内容的提问来源于stack exchange，提问作者NoobGangNB1234