Windows10配置Gradle7.3-rc-2无法初始化主类问题如何解决？

报错信息：Error: Unable to initialize main class org.gradle.launcher.GradleMain
根因：java.lang.NoClassDefFoundError: org/gradle/internal/jvm/UnsupportedJavaRuntimeException

排查步骤 #

• 验证Gradle安装包完整性
  对比你下载的gradle-7.3-rc-2压缩包的校验和与官方公布的校验值是否一致，不一致则为下载的包损坏。同时检查解压后的gradle-7.3-rc-2/lib目录下的jar包是否齐全，缺失对应jar包会触发类加载失败报错。
• 核对环境变量配置
  • 执行echo %GRADLE_HOME%，确认输出为Gradle解压根目录的完整路径，注意路径书写是否正确：比如你存放的C盘Program Files目录，正确路径格式为C:\Program Files\gradle-7.3-rc-2，漏写反斜杠、空格会导致Gradle无法定位lib目录。
  • 执行java -version和echo %JAVA_HOME%，确认Java环境配置合法：Gradle 7.3完全兼容Java 11，只要JAVA_HOME指向有效OpenJDK 11安装目录即可，JAVA_HOME配置错误会导致类加载异常。
  • 检查Path变量中Gradle bin目录配置是否为%GRADLE_HOME%\bin，避免写死绝对路径导致的配置失效。
• 检查目录访问权限
  确认当前Windows用户对Gradle解压目录有读取、执行权限，C:\Program Files属于系统级目录，权限不足会导致JVM无法读取jar包，触发类加载失败。

解决方案 #

• 安装包异常处理：删除现有解压目录，重新下载Gradle 7.3正式版（rc为候选版本，稳定性低于正式版），建议解压到无中文、无特殊字符、非系统级的目录，比如C:\gradle-7.3，规避Program Files目录的空格、权限问题。
• 环境变量修正：调整GRADLE_HOME、JAVA_HOME为正确路径后，必须重启命令行窗口生效，旧窗口会缓存之前的环境变量配置，修改后直接执行不会生效。
• 权限问题处理：右键点击Gradle解压目录，选择「属性」→「安全」，给当前用户添加「读取和执行」、「列出文件夹内容」、「读取」权限，保存后重试命令即可。

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