使用gradlew编译项目时遇‘release version 8 not supported’错误排查

错误来源 #

这个错误的核心原因是Mindustry项目的Gradle配置指定了以Java 8作为编译目标（--release 8参数），但你当前使用的JDK是17或21：

• 高版本JDK默认不会自带对Java 8编译目标的完整兼容支持，或者Gradle在选择编译环境时，没有找到能处理Java 8目标版本的JDK。
• 即使你没安装Java 8，项目配置里的sourceCompatibility/targetCompatibility或java.toolchain仍会强制Gradle尝试用Java 8标准编译，导致冲突。

查看引发错误的实际命令 #

要确认Gradle实际执行的javac命令，执行以下命令过滤调试日志：

./gradlew core:compileJava --debug | grep -A5 -B5 "javac"

输出结果里会显示完整的javac调用语句，能看到--release 8这类引发错误的参数。

另外也可以直接检查项目配置文件：

• 查看根目录build.gradle或core模块下的build.gradle，查找sourceCompatibility、targetCompatibility或java.toolchain节点，这些就是指定编译版本的地方。

解决方法 #

1. 调整项目编译版本配置 #

如果想继续用JDK 17/21编译，修改项目Gradle配置中的Java版本：
打开对应模块的build.gradle，找到类似代码并修改：

java {
    // 替换为你当前使用的JDK版本
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
    // 如果用toolchain，同步修改版本
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

⚠️ 注意：修改前确认Mindustry项目是否支持Java 17+，部分旧依赖可能存在兼容性问题。

2. 让Gradle使用Java 8编译 #

如果需要保留Java 8的编译目标，有两种方式：

• 手动安装Java 8：安装OpenJDK 8后，通过环境变量指定Gradle使用它：

  export JAVA_HOME=/path/to/openjdk-8
  ./gradlew core:compileJava
  

  或者在项目根目录的gradle.properties中添加：

  org.gradle.java.home=/path/to/openjdk-8
  

• 使用Gradle Toolchain自动下载：确保项目配置中的java.toolchain节点正确，Gradle会自动下载对应版本的JDK（需网络正常）：

  java {
      toolchain {
          languageVersion = JavaLanguageVersion.of(8)
          // 可选：指定JDK供应商
          vendor = JdkVendorSpec.ADOPTIUM
      }
  }
  

3. 安装高版本JDK的Java 8兼容包 #

在Fedora下可以安装对应兼容包，让高版本JDK支持Java 8编译目标：

sudo dnf install java-1.8.0-openjdk-devel

安装后Gradle可以自动切换JDK版本处理编译需求。

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