Java项目JDK兼容性问题应通过项目级隔离解决：确认已装JDK路径，用Maven/Gradle指定编译版本，IDE中同步设置Project SDK、Module语言级别和Run Configuration的JDK，必要时再卸载新JDK。
Java项目中遇到新JDK兼容性问题（比如Spring Boot 3.x强制要求JDK 17+，而旧模块在JDK 21下运行异常），直接“回退JDK”不是卸载重装那么简单——关键在于环境隔离、构建工具适配和IDE同步。核心思路是：不破坏系统全局配置，按项目粒度切换JDK版本。
一、确认当前JDK安装路径与可用版本
先查清机器上已安装哪些JDK，避免重复下载或误删：
- 终端执行 java -version 和 which java（macOS/Linux）或 where java（Windows），看默认指向
- 列出所有JDK目录：
• macOS：/Library/Java/JavaVirtualMachines/
• Linux：/usr/lib/jvm/ 或 $HOME/.sdkman/candidates/java/
• Windows：通常在 C:\Program Files\Java\ 或通过SDKMAN、Jabba管理 - 用 javac -version 验证编译器版本是否匹配
二、项目级JDK切换（推荐方式）
不改系统JAVA_HOME，而是让构建工具和IDE按需加载指定JDK：
-
Maven项目：在 pom.xml 中声明编译源码与目标字节码版本（不影响运行时JDK）：
<properties><br> <maven.compiler.source>11</maven.compiler.source><br> <maven.compiler.target>11</maven.compiler.target><br> <maven.compiler.release>11</maven.compiler.release><br> </properties>
-
Gradle项目：在 build.gradle 中设置：
java {<br> sourceCompatibility = JavaVersion.VERSION_11<br> targetCompatibility = JavaVersion.VERSION_11<br> } -
运行时指定JDK：启动jar包时显式调用旧版java：
/Library/Java/JavaVirtualMachines/jdk-11.0.21.jdk/Contents/Home/bin/java -jar app.jar
三、IDE中精准绑定JDK（以IntelliJ IDEA为例）
IDE的JDK配置分三层，必须全部对齐：
立即学习“Java免费学习笔记（深入）”；
- Project SDK：File → Project Structure → Project → Project SDK → 选择已安装的JDK 11（如未列出，点“Add JDK…”手动定位）
- Module language level：同页面中Module Settings → Modules → Sources → Language level → 设为“11 (LTS)”
- Run Configuration JDK：Edit Configurations → 修改对应Application配置 → JRE → 选同一JDK 11路径
四、彻底卸载新JDK（仅当必须清理时）
若新JDK引发冲突且不再需要，可安全卸载（注意备份关键配置）：
- macOS：直接删除 /Library/Java/JavaVirtualMachines/jdk-21.jdk
- Linux：用包管理器移除（如 sudo apt remove openjdk-21-jdk）或手动删 /usr/lib/jvm/jdk-21
- Windows：控制面板 → 卸载程序 → 找到“JDK 21” → 卸载；再检查并更新系统环境变量 JAVA_HOME 和 Path
- 卸载后验证：java -version 应返回残留的旧版本（如JDK 11），否则需手动重设 JAVA_HOME
回滚的本质不是倒退，而是精准控制版本边界。只要JDK安装路径清晰、构建配置明确、IDE上下文一致，切换就像换插头一样简单——真正麻烦的从来不是JDK本身，而是没理清“谁在什么时候用了哪个JDK”。
