Java环境变量配置失效的核心是系统未加载、调用路径错误或被覆盖：需先用echo验证JAVA_HOME是否指向JDK根目录（不含bin），再用where/which确认%JAVA_HOME%\bin在PATH中靠前且生效，最后重启终端/IDE并检查Hadoop等工具脚本是否硬编码覆盖。
Java 环境变量配置错误不是“配错了”，而是系统没读到、读到了但用错了，或被其他层级覆盖了。处理的核心是分层验证、逐级排除，不靠猜，只看实际生效值。
确认 JAVA_HOME 是否真实存在且路径正确
这是所有问题的起点。很多报错（如 Hadoop 的 JAVA_HOME is incorrectly set）直接源于此：
- 在命令行中执行
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（Linux/macOS），输出必须是非空、可访问的完整路径； - 路径必须指向 JDK 根目录（含
bin/、lib/、jre/），不能是 JRE，也不能带\bin或末尾反斜杠； - 路径中含空格（如
Program Files）时，Windows 下不要加英文引号，Hadoop 等脚本会解析失败；推荐改用无空格路径，例如C:\jdk\jdk-17。
检查 PATH 中是否真正包含 %JAVA_HOME%\bin 且顺序靠前
PATH 决定命令调用优先级。即使 JAVA_HOME 正确，PATH 错了也会调到别的 Java：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 运行
where java（Windows）或which java（Linux/macOS），看返回路径是否与%JAVA_HOME%\bin一致； - 确保
%JAVA_HOME%\bin是 PATH 中一条独立条目，且排在所有其他 Java 相关路径之前（尤其避开javapath这类 Oracle 自动注入路径）； - Linux/macOS 中写法必须是
export PATH=$JAVA_HOME/bin:$PATH，$JAVA_HOME/bin必须在最前面。
验证配置是否已加载进当前会话
改完环境变量 ≠ 当前窗口立刻生效：
立即学习“Java免费学习笔记（深入）”；
- Windows：关闭所有 CMD/PowerShell，**新开一个窗口**再测试；IDE（如 IntelliJ、Eclipse）需完全退出并重启，桌面快捷方式启动的 IDE 不继承新终端环境；
- Linux/macOS：修改
~/.zshrc或~/.bashrc后，必须运行source ~/.zshrc；先用echo $SHELL确认当前 shell 类型，别改错文件； - VS Code 内置终端默认非 login shell，建议在设置中启用
terminal.integrated.inheritEnv并重启终端。
排查脚本或工具自身的环境覆盖行为
很多 Java 工具（如 Hadoop、Tomcat、Maven）会在启动时读取自己的配置文件，强行覆盖系统变量：
- Hadoop 的
etc/hadoop/hadoop-env.cmd（Windows）或hadoop-env.sh（Linux）中，查找set JAVA_HOME=...或export JAVA_HOME=...； - 若存在硬编码路径，注释掉，改为显式设置正确路径（如
set JAVA_HOME=C:\jdk\jdk-17）； - Maven 的
mvn脚本、Tomcat 的catalina.bat/sh同理，优先检查其 bin 目录下的启动脚本。
