Gradle构建报错：无法识别VM选项‘MaxPermSize=512m’（Gradle7.6.4+OpenJDK17）

问题原因 #

Java 8及以后版本已移除永久代（PermGen），改用元空间（Metaspace）管理类元数据，-XX:MaxPermSize这个JVM参数在OpenJDK 17中不再被支持。你的Gradle守护进程启动命令包含了该无效参数，导致启动失败。

解决步骤 #

需要移除所有配置中的-XX:MaxPermSize=512m参数，常见配置位置如下：

• 项目本地gradle.properties
  打开项目根目录下的gradle.properties文件，找到包含org.gradle.jvmargs的配置行：

  org.gradle.jvmargs=-XX:MaxPermSize=512m -XX:MaxMetaspaceSize=512m -Xmx4g ...
  

  删除其中的-XX:MaxPermSize=512m，修改后示例：

  org.gradle.jvmargs=-XX:MaxMetaspaceSize=512m -Xmx4g ...
  

• 用户全局gradle.properties
  打开用户主目录下的.gradle/gradle.properties（路径通常为~/.gradle/gradle.properties），重复上述操作移除无效参数。

• 系统环境变量
  检查GRADLE_OPTS或JAVA_OPTS环境变量，若包含-XX:MaxPermSize=512m则删除该部分。

验证修改 #

执行gradle --stop停止当前Gradle守护进程，再重新运行gradle build即可正常执行。

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