IntelliJ 中解决 "Invalid source release: 17" 错误

问题描述

在使用 IntelliJ IDEA 创建 Java 17 项目时，许多开发者会遇到 Cause: error: invalid source release: 17 错误。这个问题通常在以下情况出现：

• 项目已正确配置使用 Java 17 作为 Project SDK
• 语言级别设置为 "17 - Sealed types, always-strict floating-point semantics"
• 模块依赖项中使用 Project SDK openjdk-17
• 编译器字节码版本设置为 17
• Gradle 配置中设置了 sourceCompatibility = '17'

核心解决方案

1. 设置 Gradle JVM（推荐方案）

这是最常见且有效的解决方法：

1. 打开 File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle
2. 在 Gradle JVM 下拉菜单中选择 Java 17 SDK
3. 点击 OK 保存设置

INFO

此设置确保 Gradle 使用正确的 Java 版本进行编译，而不是使用系统默认的 Java 版本。

2. 配置 Gradle 工具链

在 build.gradle 文件中添加工具链配置，这是最可靠的跨平台解决方案：

build.gradle.kts

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(17))
    }
}

build.gradle

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

TIP

使用工具链配置的优势：

• 确保所有开发者和构建环境使用相同的 Java 版本
• 不需要每个开发者手动配置 IDE 设置
• 支持跨平台一致性

3. 检查并设置 JAVA_HOME 环境变量

确保系统环境变量指向正确的 Java 17 安装路径：

# 检查当前 JAVA_HOME
echo $JAVA_HOME  # Linux/Mac
echo %JAVA_HOME% # Windows

# 设置 JAVA_HOME (临时)
export JAVA_HOME=/path/to/jdk-17  # Linux/Mac
set JAVA_HOME=C:\path\to\jdk-17   # Windows

WARNING

永久设置环境变量需要在系统设置中配置，临时设置只在当前终端会话有效。

其他可能的原因和解决方法

4. 检查项目结构配置

确保所有相关设置都使用 Java 17：

1. File -> Project Structure -> Project -> SDK：选择 JDK 17
2. File -> Project Structure -> Project -> Language level：选择 17
3. File -> Project Structure -> Modules -> Sources：语言级别设置为项目默认
4. File -> Project Structure -> Modules -> Dependencies：模块 SDK 设置为项目 SDK

5. 清理旧的 JDK 配置

有时系统中存在多个 JDK 版本会导致冲突：

• 删除系统 PATH 中的旧 JDK 引用
• 检查并移除 ~/.gradle/gradle.properties 中的旧 org.gradle.java.home 设置
• 删除系统环境变量中指向旧版本 JDK 的配置

6. 验证终端和执行配置

确保终端中的 Java 版本与 IntelliJ 配置一致：

# 检查 Java 版本
java -version
javac -version

在 IntelliJ 中检查运行配置：

• Run -> Edit Configurations...
• 确保 JRE 指向正确的 JDK 17 安装路径

故障排除流程

遇到此问题时，建议按以下顺序排查：

1. ✅ 首先检查并设置 Gradle JVM
2. ✅ 验证 Gradle 工具链配置
3. ✅ 检查系统 JAVA_HOME 环境变量
4. ✅ 确认项目结构中的所有相关设置
5. ✅ 清理可能冲突的旧 JDK 配置

总结

"Invalid source release: 17" 错误通常是由于构建工具（Gradle）使用的 Java 版本与项目配置不一致导致的。通过正确配置 Gradle JVM 或使用 Gradle 工具链功能，可以确保所有构建环境使用一致的 Java 版本，从而解决这个问题。

重要提醒

避免使用过时的解决方案，如手动设置 sourceCompatibility = '11'，这会限制项目无法使用 Java 17 的新特性。正确的做法是确保环境正确配置以支持 Java 17。

采用上述推荐解决方案后，您的 Java 17 项目应该能够正常编译和运行。如果问题仍然存在，建议检查项目中的所有配置文件，确保没有其他地方覆盖了 Java 版本设置。