【报错解决】java：无效的目标发行版：17；源发行版17需要目标发行版17
问题描述
1、新建空项目时，设置项目SDK为1.8，language level也是8
2、新建模块时，模块JDK也设置成项目JDK即1.8
3、新建后，确认了Project Structure中Project部分的SDK和language level都是对的
问题出现：运行一个测试方法时，提示 java：无效的目标发行版：17；源发行版 17 需要目标发行版 17
这时发现Project Structure中Modules部分中那个新建的模块的language level是17，修改后，再使用mvn clean compile，再运行测试方法仍然报错如上
问题解决
1、检查pom.xml文件（没问题）
<properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target>
</properties>
1、检查IntelliJ IDEA的Maven设置：（没问题）
打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven → Runner
找到 JRE 选项，确保选择的是 Project JDK 或明确选择 Java 8
2、检查IntelliJ IDEA的Java Compiler设置（问题所在）
打开 Settings → Build, Execution, Deployment → Compiler → Java Compiler
- 查看 Project bytecode version 是否设置为 17
- 查看 Per-module bytecode version 表格中，project01 模块的 Target bytecode version 是否被设置为 17
- 建议：将这些都改为 8 或留空（使用项目默认）
发现这里的project01 模块的 Target bytecode version 果然仍然是17，而不是笔者所需要的8
问题出现的原因
为什么会出现该问题？配置优先级导致的覆盖
配置优先级顺序（从高到低）：
- Java Compiler的Per-module设置（最高优先级）← 这里被设置成了17
- Maven的compiler插件配置
- POM文件中的 maven.compiler.target
- Project SDK设置
所以即使POM文件配置正确（Java 8），但Per-module设置（Java 17）优先级更高，就会覆盖它。
Java版本冲突排查顺序
每次创建新模块后：
✓ 检查 Project Structure → Modules → Language level
✓ 检查 Settings → Compiler → Java Compiler → Per-module设置
✓ 执行一次 mvn clean compile 验证
第一优先级：IDE编译器设置（80%的问题在这里）
- Java Compiler - Per-module设置（最高优先级）
Settings → Build, Execution, Deployment → Compiler → Java Compiler
- ✓ 检查 Per-module bytecode version 表格
- ✓ 确认问题模块的 Target bytecode version
- ✓ 操作：删除或改为正确版本
- Project Structure - Modules
File → Project Structure → Modules → [选择模块] → Language level
- ✓ 检查每个模块的 Language level
- ✓ 操作：改为与SDK一致的版本
- Project Structure - Project
File → Project Structure → Project
- ✓ 检查 Project SDK
- ✓ 检查 Project language level
- ✓ 操作：确保两者一致
第二优先级：Maven配置
- POM文件 - properties
<properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target>
</properties>
- POM文件 - compiler插件（如果存在）
<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><configuration><source>8</source><target>8</target><release>8</release> <!-- 注意这个！--></configuration></plugin></plugins>
</build>
- Maven Runner - JRE设置
Settings → Build, Execution, Deployment → Build Tools → Maven → Runner
- ✓ 检查 JRE 是否使用 Project JDK
第三优先级：外部配置（少见但可能）
- 项目的.mvn目录
项目根目录/.mvn/
- ✓ 检查 jvm.config 文件（是否有 --release 17）
- ✓ 检查 maven.config 文件
- Maven全局settings.xml
~/.m2/settings.xml
- ✓ 检查是否有激活的 profile 设置了Java版本
修改后的标准操作：
- 修改完配置
- File → Invalidate Caches / Restart
- 右键POM → Maven → Reload project
- mvn clean compile 验证
预防措施：
创建新模块后，必查 Per-module bytecode version
定期检查 Java Compiler 设置，保持为空（使用项目默认）
在POM中明确指定compiler插件配置