在日常 Java 开发中，很多初学者在使用 IDEA 或 Eclipse 编译运行项目时，经常会遇到类似的错误提示：

java: 错误: 无效的源发行版: 8

或者：

java: 错误: 无效的源发行版: 11

java: 错误: 无效的源发行版: 17

java: 错误: 无效的源发行版: 21

那么，这类错误到底是什么意思？该如何解决？本文将带你从原理到实战全面解析。

一、什么是“无效的源发行版”错误？

Java 编译器在编译源码时，会检查 --source 和 --target 选项，确定编译时的 Java 语法版本和生成的字节码版本。

source：源码兼容的版本（比如 --source 8 代表源码必须符合 Java 8 的语法规则）

target：字节码生成的版本（比如 --target 8 代表生成的 class 文件兼容 Java 8 的 JVM）

当你使用的 JDK 不支持某个 source 版本 时，就会出现 无效的源发行版 的错误。

举例：

使用 JDK 8 编译时设置了 --source 11 → JDK 8 并不认识 Java 11 的语法规则

使用 JDK 17 编译时设置了 --source 21 → JDK 17 并没有实现 Java 21 的特性

二、如何解决？

步骤一：确保本地已经安装了对应的 jdk 版本

确保本地已经安装了期望的版本（比如 JDK 8）。如果本地没安装对应的 jdk 版本，先参考这篇文章安装：JDK8 安装教程

步骤二：修改 IDEA 的如下配置

打开 File → Project Structure → Project

打开 File → Project Structure → Modules

打开 File --> Settings–> Build,Execution,Deployment–> Java Compiler;

如果 pom.xml 中指定了 jdk 版本，就将 jdk 版本进行修改，没有指定则不用修改

1.8

1.8

三、不同 JDK 版本支持情况对照表

JDK 版本

支持的 --source

说明

JDK 8

1.6, 1.7, 1.8

不能支持 11、17

JDK 11

8, 9, 10, 11

不能支持 17、21

JDK 17

8~17

不能支持 21

JDK 21

8~21

最新 LTS 版本，推荐使用

四、总结

出现 “无效的源发行版” 错误，通常是因为 JDK 版本与项目配置的 source/target 不匹配。

解决思路很简单：

确认你安装了正确的 JDK

在 IDE、Maven 中设置对应的版本号

确保 source 和 target 不超过 JDK 的最高支持范围

掌握了这些技巧，就能轻松避免类似的编译报错。