问题：IDEA Java编译报错“无效的源发行版: 19”如何解决？

Question

在使用 IntelliJ IDEA 进行 Java 开发时，开发者可能会遇到编译报错：“无效的源发行版: 19”（“Invalid source release: 19”）。该问题通常出现在项目配置中指定了不被当前 JDK 或 IDEA 版本支持的 Java 版本。例如，当你在项目设置中将语言级别设为 Java 19，但使用的 JDK 版本较低或 IDEA 本身不支持 Java 19 的编译特性时，就会触发此错误。 要解决这个问题，首先应检查并确保你使用的 JDK 版本为 JDK 19 或以上；其次，确认 IntelliJ IDEA 的版本是否支持 Java 19（建议使用 IDEA 2022.1 及以上版本）；最后，在项目设置中（File → Project Structure）和模块的语言级别配置中，确保所有 Java 编译选项与所用 JDK 版本一致。 通过统一 JDK 版本与 IDE 配置，可有效避免“无效的源发行版: 19”的编译错误。

Answer 1

一、问题现象：IntelliJ IDEA 编译报错 “无效的源发行版: 19”

在使用 IntelliJ IDEA 进行 Java 开发时，开发者可能会遇到如下编译错误：

Error:java: 无效的源发行版: 19

该错误提示表明当前项目配置中指定了 Java 版本为 19，但当前使用的 JDK 或 IDE 不支持该版本。

二、问题原因分析

该错误通常由以下三种原因导致：

1. JDK 版本过低，未安装或配置 JDK 19 及以上版本；
2. IntelliJ IDEA 版本不支持 Java 19（建议使用 IDEA 2022.1 及以上版本）；
3. 项目语言级别设置错误，模块或项目的源码兼容性配置与实际 JDK 不一致。

2.1 JDK 支持情况

Java 每个新版本都会带来新的语言特性与 API，旧版本 JDK 无法识别新版本的语法结构。例如：

Java 版本	对应源发行版参数	要求的最低 JDK 版本
Java 8	--source 8	1.8.x
Java 17	--source 17	17.x.x
Java 19	--source 19	19.x.x

2.2 IntelliJ IDEA 支持情况

不同版本的 IntelliJ IDEA 对 Java 新特性的支持程度不同。以下是部分版本的支持情况：

• IDEA 2021.3 及更早版本：不支持 Java 19；
• IDEA 2022.1 开始：初步支持 Java 19 的语法和特性；
• IDEA 2022.3+：完整支持 Java 19。

三、解决方案详解

要解决“无效的源发行版: 19”的问题，需要从以下几个方面进行检查和调整：

3.1 确认 JDK 是否为 19 或更高版本

首先确认系统中是否已安装 JDK 19，并正确配置了环境变量。

$ java -version
openjdk version "19.0.1" 2022-10-18
OpenJDK Runtime Environment (build 19.0.1+10)
OpenJDK 64-Bit Server VM (build 19.0.1+10, mixed mode, sharing)

若输出版本低于 19，则需升级 JDK。

3.2 配置 IntelliJ IDEA 使用 JDK 19

进入 IntelliJ IDEA 设置界面，指定全局 JDK：

1. 打开菜单：File → Project Structure → SDKs；
2. 点击 "+" 添加 JDK 19 安装路径；
3. 确保 Project SDK 和 Module SDK 均选择 JDK 19。

3.3 调整模块的语言级别设置

进入模块设置页面，修改语言级别：

1. File → Project Structure → Modules；
2. 将 Language level 设置为 "19 - Pattern matching..." 或更高；
3. 确认 Compiler output 输出路径正确。

3.4 检查 Maven/Gradle 构建工具配置

如果使用 Maven 或 Gradle 构建项目，还需检查其插件配置是否支持 Java 19：

• Maven：maven-compiler-plugin 中应包含：

• <properties>
    <maven.compiler.source>19</maven.compiler.source>
    <maven.compiler.target>19</maven.compiler.target>
  </properties>

• Gradle：build.gradle 中添加：

• tasks.withType(JavaCompile) {
    options.release.set(19)
  }

3.5 更新 IntelliJ IDEA 至支持版本

如使用较老版本 IDEA，可前往官网下载最新版本（建议使用 2022.1 及以上）：

• 官网地址：https://www.jetbrains.com/idea/

四、流程图总结

以下是整个排查和解决流程的可视化表示：

graph TD
  A[开始] --> B{检查JDK版本}
  B -->|版本≥19| C[检查IDEA版本]
  B -->|版本<19| D[升级JDK至19+]
  C -->|≥2022.1| E[配置Project SDK为JDK19]
  C -->|<2022.1| F[升级IDEA至2022.1+]
  E --> G{模块语言级别是否为19?}
  G -->|是| H[检查构建工具配置]
  G -->|否| I[调整模块Language Level为19]
  H --> J[编译成功]
  I --> H