Java程序启动失败主因是环境变量配置不准确，需分步验证：先确认JAVA_HOME指向JDK根目录且路径有效，再检查PATH是否正确包含%JAVA_HOME%\bin或$JAVA_HOME/bin，接着排除多版本冲突与缓存未刷新，最后仅在必要时谨慎设置CLASSPATH。
环境变量配置不当是 Java 程序无法启动或运行报错的最常见原因，占实际故障的 60% 以上。问题往往不在于“没配”，而在于“配得不准确”或“没真正生效”。处理关键不是重装 JDK，而是分步验证、精准定位。
确认 JAVA_HOME 是否指向正确的 JDK 根目录
JAVA_HOME 必须严格指向 JDK 安装的根文件夹（如 C:\Program Files\Java\jdk-17.0.2 或 /usr/lib/jvm/java-17-openjdk-amd64），不能是 jre 目录，也不能是 bin 子目录，更不能带尾部反斜杠或中文路径。
- Windows：在命令行执行 echo %JAVA_HOME%，检查输出路径是否存在、是否可访问、是否含空格/中文（如有，需确保所有引用处加英文引号）
- Linux/macOS：运行 echo $JAVA_HOME，再执行 ls -l $JAVA_HOME/bin/java 验证 java 可执行文件真实存在
- 常见错误：把
C:\Program Files\Java\jdk-17.0.2\bin当成 JAVA_HOME —— 这会导致 javac 找不到，因为 tools.jar 不在 bin 下
检查 PATH 是否正确包含 %JAVA_HOME%\bin 或 $JAVA_HOME/bin
PATH 决定系统在哪找 java、javac 命令。它必须引用 JAVA_HOME 的 bin 目录，而不是写死绝对路径（否则 JDK 升级后立即失效）。
- Windows：PATH 中应有 %JAVA_HOME%\bin，且不能写成
%JAVA_HOME%/bin（正斜杠不识别）或%JAVA_HOME%\bin\（末尾反斜杠可能干扰） - Linux/macOS：~/.bashrc 或 ~/.zshrc 中应有 export PATH=$JAVA_HOME/bin:$PATH，修改后需运行 source ~/.zshrc（或对应 shell 文件）
- 验证方法：新开一个终端，运行 where java（Win）或 which java（macOS/Linux），确认返回路径与 $JAVA_HOME/bin 一致
排除多版本冲突与缓存未刷新
一台机器装了多个 JDK 很常见，但 PATH 中靠前的 java 路径会优先生效，容易调用错版本；环境变量改完不重启终端，系统也不会自动加载新值。
立即学习“Java免费学习笔记（深入）”；
- 查实际调用版本：运行 java -version 和 javac -version，两者输出主版本号应一致（如都是 17）；若不一致，说明 PATH 混乱
- 查看全部 java 位置：Windows 执行 where java，Linux/macOS 执行 ls /usr/lib/jvm/ 或 find /opt -name "java" -path "*/bin/java" 2>/dev/null
- 强制刷新：关闭所有终端和 IDE，重新打开；IDE（如 IntelliJ）还需在 File → Project Structure → SDKs 中手动指定 JDK 路径，不依赖系统变量
验证 CLASSPATH（仅当明确需要时）
绝大多数现代项目（Maven/Gradle）无需手动设 CLASSPATH。只有运行裸 class 文件或老式脚本时才可能涉及。若必须设置：
- 临时测试：运行 java -cp ".;lib/spring-core.jar" MyApp（Windows）或 java -cp ".:lib/spring-core.jar" MyApp（Linux/macOS）
- 避免全局 CLASSPATH：除非 ERP 或遗留系统强制要求，否则不要在系统环境变量中设 CLASSPATH——它会覆盖 JVM 默认的当前目录（.）查找逻辑，反而导致“找不到主类”
- 检查是否误加：运行 echo %CLASSPATH%（Win）或 echo $CLASSPATH（macOS/Linux），若非空且内容可疑，建议清空
