Gradle构建Minecraft Forge 1.19.2时JVM堆内存参数报错求助

核心问题分析 #

你使用的是32位(x86)的JDK17，32位JVM受内存地址空间限制，最大可分配堆内存通常在2G左右（实际环境中一般不超过2.5G），所以设置-Xmx4G、3G都会触发内存超限报错；降到512M虽能启动JVM，但后续Forge构建所需内存远大于该值，必然会再次报错。

具体解决步骤 #

• 替换为64位JDK17
  下载64位版本的Eclipse Temurin JDK17.0.8.1+1，安装后在IntelliJ IDEA中完成配置：

  1. 打开File > Project Structure > Project，将Project SDK切换为刚安装的64位JDK17
  2. 进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在Gradle JVM选项中选择同一个64位JDK

• 调整gradle.properties的JVM参数
  打开项目根目录的gradle.properties，修改JVM参数为适合64位环境的值，例如：

  org.gradle.jvmargs=-Xmx6G -XX:MaxMetaspaceSize=512M -Dfile.encoding=UTF-8
  

  （Forge 1.19.2构建推荐至少4G堆内存，6G可有效避免内存不足问题）

• 清理Gradle缓存与守护进程

  1. 在项目根目录的终端执行命令停止所有Gradle守护进程：

     gradlew --stop
     

  2. 删除用户目录下的.gradle/caches和.gradle/daemon文件夹（路径一般为C:\Users\[你的用户名]\.gradle）
  3. 重新执行构建命令

• 排查无效JVM参数
  检查gradle.properties中是否存在JDK17不支持的旧版参数（如过时的GC配置），如有则删除，避免触发守护进程启动失败的报错

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