核心是确认java和javac是否调用同一JDK、是否受PATH顺序干扰及是否被系统/IDE缓存覆盖；须用where/java或which/javac查真实路径，确保二者均指向%JAVA_HOME%\bin且版本一致，PATH中仅保留该路径并置顶，改后需重启终端和IDE验证。
Java 环境变量冲突的排查核心是确认 java 和 javac 是否调用同一 JDK、是否受 PATH 顺序干扰、以及是否被系统/用户变量或 IDE 缓存覆盖。不是看“装没装”，而是查“调用谁”。
查真实调用路径，别信 java -version
java -version 只显示运行时版本，不反映实际执行文件位置。必须用底层命令定位：
- Windows：运行 where java 和 where javac，第一行输出路径必须完全一致，且都落在
%JAVA_HOME%\bin下 - macOS/Linux：运行 which java 和 which javac，再用 readlink -f $(which java) 和 readlink -f $(which javac) 查最终指向
- 若
javac找不到，说明 PATH 没包含 JDK 的 bin，只加了 JRE；若两个路径不同，说明 PATH 中存在多个 Java 条目且顺序错乱
核对 JAVA_HOME 是否规范有效
JAVA_HOME 是整个链条的锚点，错一点，全盘失效：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 值必须是 JDK 根目录（含
bin、lib、jre子目录），不能带\bin，也不能以反斜杠结尾（C:\jdk-17\❌，C:\jdk-17✅） - 不能指向 JRE（如
C:\Program Files\Java\jre1.8.0_301），否则javac必然缺失 - Windows 中不要加英文引号；Linux/macOS 的 shell 配置中写法为
export JAVA_HOME=/opt/jdk-17，不能漏掉export - 运行 echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux）验证是否输出预期路径
检查 PATH 顺序与冗余项
PATH 是从左到右匹配，谁在前面谁生效。冲突几乎都源于“多条 Java 路径 + 顺序错误”：
立即学习“Java免费学习笔记（深入）”；
- 打开环境变量编辑器，检查 PATH 列表中是否存在除
%JAVA_HOME%\bin外的其他 Java 相关路径，例如：
C:\Program Files (x86)\Common Files\Oracle\Java\javapath
C:\Program Files\Java\jre1.8.0_301\bin
E:\oracle\ora92\bin（Oracle 客户端常偷偷注入） - 确保
%JAVA_HOME%\bin是独立条目，且被移到 PATH 列表最顶端 - 删除所有硬编码的 Java 路径，只保留
%JAVA_HOME%\bin—— 这是唯一可控、可切换的源头 - Linux/macOS 用户注意：
export PATH=$JAVA_HOME/bin:$PATH中$JAVA_HOME/bin必须在前，不能写成$PATH:$JAVA_HOME/bin
验证是否真正生效
改完不重启 = 白改。旧终端进程不会自动更新环境变量：
- 关闭所有已打开的 CMD、PowerShell、IDE（IntelliJ/Eclipse/VS Code）、甚至资源管理器窗口（部分版本会继承环境）
- 新开一个终端，立即执行三组命令：
echo %JAVA_HOME% → 应输出 JDK 根路径
java -version 与 javac -version → 版本号必须完全一致
where java（Windows）或 which java（macOS/Linux）→ 第一行必须是%JAVA_HOME%\bin\java.exe或对应路径 - IDE 需单独处理：IntelliJ 要进 File → Project Structure → SDKs 确认项目 JDK 指向
%JAVA_HOME%；Eclipse 进 Window → Preferences → Java → Installed JREs 检查并修复；必要时执行 Invalidate Caches
