Gradle项目需显式配置Java 17：Gradle 7.0+用java { version = JavaVersion.VERSION_17 }，旧版用sourceCompatibility='17'与targetCompatibility='17'，并确认org.gradle.java.home指向正确JDK路径。
Gradle项目中如何正确配置build.gradle以支持Java 17+
Java版本不匹配是编译失败最常见原因，Gradle默认不会自动适配JDK新特性。必须显式声明源码与目标字节码版本，否则即使本地装了Java 17，javac仍可能用Java 8规则编译。
-
java { version = JavaVersion.VERSION_17 }（Gradle 7.0+）或旧版用sourceCompatibility = '17'+targetCompatibility = '17' - 若用
spring-boot-starter-parent，优先通过17 pom.xml里统一控制，避免Gradle与Maven行为不一致 - 检查
gradle.properties中org.gradle.java.home是否指向正确的JDK路径，否则./gradlew compileJava会静默使用系统默认JDK
Maven项目里pom.xml的Java版本与插件绑定要点
Maven不光靠properties声明Java版本，关键在于maven-compiler-plugin是否实际生效。很多项目只改了java.version却忘了插件配置，导致mvn compile仍用Java 8语法校验。
- 必须显式配置插件，不能只依赖父POM继承：
org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17 UTF-8 - Spring Boot 3.x起强制要求Java 17+，若用
spring-boot-starter-parent3.0.0+，删掉插件配置反而会触发警告——此时应确保父POM版本与JDK严格对齐 -
mvn -X compile可查看实际生效的source/target值，比看pom.xml更可靠
Gradle与Maven共存项目中如何避免构建冲突
混合使用build.gradle和pom.xml（比如IDE自动生成、遗留脚本残留）会导致构建行为不可预测。Gradle不会读取pom.xml，Maven也无视build.gradle，但IDE可能同时加载两者并产生矛盾提示。
- 确认项目根目录下只存在一种构建描述文件：
build.gradle（含settings.gradle）或pom.xml，不要共存 - IntelliJ中右键项目 → “Reload project” 时，选择“Gradle”或“Maven”单一模式，禁用自动检测
- CI脚本中明确指定命令：
./gradlew build或mvn clean package，禁止混用mvn compile && ./gradlew test这类组合
为什么mvn dependency:tree和./gradlew dependencies显示的依赖树不一致
不是Bug，是设计差异：Maven按POM声明顺序解析，Gradle按依赖图拓扑排序，且各自处理optional、exclusions、BOM导入的逻辑不同。同一坐标在两套体系中可能被不同策略裁剪。
立即学习“Java免费学习笔记（深入）”；
- Gradle中
./gradlew dependencies --configuration compileClasspath才对应Maven的compile范围，别用runtimeClasspath去对比 - Maven的
dependency:tree -Dverbose能显示被省略的冲突节点，Gradle需加--scan参数生成可视化报告 - 真正要验证依赖一致性，应以
mvn dependency:list和./gradlew classpath输出的最终JAR列表为准，而非树形结构
java -version显示17，不代表gradle或mvn命令调用的就是它。每次换JDK后，务必重跑./gradlew --version和mvn -v确认。 
