1. 问题现象
在使用 Maven 或 Gradle 编译 Java 项目时，控制台输出如下警告：
java: 警告: 源发行版 17 需要目标发行版 17
该警告表示当前编译的源代码版本（source）为 17，但目标字节码版本（target）未同步设置为 17，导致编译器提示两者不一致。
2. 原因分析
Java 编译器要求 –source 与 –target 版本保持一致或兼容。当只指定了源发行版而未指定目标发行版时，编译器会使用默认目标版本，从而产生上述警告。常见触发场景包括：
- IDE 中项目语言级别设置为 17，但编译插件未显式配置 maven.compiler.target。
- Maven 的 pom.xml 中只配置了 maven.compiler.source，遗漏了 maven.compiler.target。
- Gradle 的 build.gradle 中只设置了 sourceCompatibility，未设置 targetCompatibility。
3. 解决方法
3.1 Maven 项目
在 pom.xml 中同时指定 source 和 target 版本：
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
也可以使用 maven-compiler-plugin 显式配置：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>17</source>
<target>17</target>
</configuration>
</plugin>
</plugins>
</build>
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjU3NS5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjY0MS5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQ3Ni5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjU0MC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQ2OC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjYzMC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjUyNy5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQyOC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjE4My5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NTk3NC5zaHRtbA==.html
3.2 Gradle 项目
在 build.gradle 中同时设置：
java {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
3.3 命令行直接编译
使用 javac 时同时指定两个参数：
javac –release 17 Hello.java
推荐使用 –release，它会同时约束 source、target 和系统 API 版本，避免遗漏。
4. 验证结果
配置完成后重新编译，警告应消失。可通过以下命令确认编译版本：
javap -verbose 类名 | grep "major version"
若输出 major version 61，说明字节码版本确为 Java 17。
5. 总结
该警告的本质是 source 与 target 版本不一致。解决思路是让两者显式对齐，推荐在构建工具中统一配置，或直接使用 –release 参数。配置完成后，编译输出将不再出现该警告。
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjU3NS5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjY0MS5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQ3Ni5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjU0MC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQ2OC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjYzMC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjUyNy5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjQyOC5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NjE4My5zaHRtbA==.html
https://tv.sohu.com/v/dXMvNDQzOTQ3ODkxLzc0MTk3NTk3NC5zaHRtbA==.html
