java环境混乱主因是旧jdk残留导致java_home指向失效；需清理注册表（windows）、配置文件及/library/java/javavirtualmachines（macos），推荐用sdkman!统一管理版本，并验证ide、maven、gradle实际使用的jdk是否一致。
清理残留的 JDK 安装和 JAVA_HOME 配置冲突
Java 环境混乱的根源，往往不是没装新版本，而是旧 JDK 残留导致 JAVA_HOME 指向失效或 java -version 与预期不符。Windows 上手动删了 C:\Program Files\Java\jdk-xx 目录取不了作用——注册表里还存着旧路径；macOS/Linux 则常见 /usr/libexec/java_home -V 列出多个版本但 shell 中的 JAVA_HOME 仍指向已卸载的路径。
- 先执行
/usr/libexec/java_home -V（macOS）或where java+java -XshowSettings:properties -version 2>&1 | findstr "java.home"（Windows）确认当前真实生效路径 - 检查并清空
JAVA_HOME环境变量：Windows 在系统属性→环境变量中删除该变量；macOS/Linux 检查~/.zshrc、~/.bash_profile或/etc/profile中的export JAVA_HOME=...行 - macOS 用户特别注意：
/Library/Java/JavaVirtualMachines/下残留的 .jdk 包必须手动删除，否则java_home -V仍会列出它
用 SDKMAN! 统一管理多 JDK 版本（推荐 macOS/Linux）
手动切换 JAVA_HOME 和修改 PATH 极易出错，尤其在 Maven、Gradle、IDE 各自读取不同环境时。SDKMAN! 是轻量级、shell 原生集成的版本管理器，不依赖 Docker 或虚拟机，且对 Java 生态支持最成熟。
- 安装后运行
sdk list java查看可用版本（含 Temurin、Liberica、Amazon Corretto 等主流构建） - 安装指定版本：
sdk install java 17.0.12-tem，再用sdk use java 17.0.12-tem临时切换，或sdk default java 17.0.12-tem设为全局默认 - IDEA/Eclipse 无需额外配置：它们启动时自动读取 shell 的
JAVA_HOME，只要在终端中用sdk切换后重启 IDE 即可生效 - 注意：Windows 不原生支持 SDKMAN!，如需类似体验，改用
jabba或直接使用Chocolatey + choco install openjdk
验证 IDE 和构建工具是否真正使用新 JDK
很多人改完系统环境变量就以为万事大吉，结果 mvn compile 报 Unsupported class file major version 65（JDK 21 字节码），或 IDEA 里 Project SDK 显示是 JDK 17，但 Maven home directory 下的 mvn 脚本却自带 JAVA_HOME 覆盖逻辑。
- 在 IDEA 中：File → Project Structure → Project → Project SDK 必须手动选中刚安装的 JDK；同时检查 Settings → Build → Build Tools → Maven → Importing → JDK for importer 是否也设为同一版本
- 在终端中运行
mvn -v，确认输出的Java version和JAVA_HOME路径与预期一致；若不一致，检查MAVEN_OPTS或maven-wrapper的mvnw脚本是否硬编码了 JDK 路径 - Gradle 用户注意：
gradle.properties中的org.gradle.java.home优先级高于系统JAVA_HOME，务必检查该配置项是否存在且指向正确
清理 Maven 本地仓库中的不兼容依赖缓存
升级 JDK 后，即使编译通过，运行时也可能抛 java.lang.NoClassDefFoundError: javax/xml/bind/JAXBContext（JDK 9+ 移除了 JAXB）或 IllegalAccessError（模块系统限制）。这不是环境问题，而是旧版依赖（如老 Spring Boot 2.1.x）在 JDK 17+ 下加载失败。
立即学习“Java免费学习笔记（深入）”；
- 不要盲目
rm -rf ~/.m2/repository——这会重下所有依赖，耗时且未必解决问题；应定位具体失败的坐标，例如mvn dependency:tree | grep jaxb - 对明确不兼容的依赖（如
javax.xml.bind:jaxb-api），在pom.xml中显式添加对应替代包：jakarta.xml.bind:jakarta.xml.bind-api，并排除传递依赖 - Spring Boot 项目建议同步升级
spring-boot-starter-parent版本，例如从2.7.x升到3.2.x（要求 JDK 17+），避免手动打补丁
