Java环境变量配置错误最常见的是JAVA_HOME、PATH、CLASSPATH混淆或设置不全，如JAVA_HOME误指JRE目录、PATH漏配%JAVA_HOME%\bin，或未处理Windows路径空格；须确保安装JDK而非仅JRE，并验证java -version与javac -version。
Java环境变量配置错误
最常见的问题是JAVA_HOME、PATH和CLASSPATH三者混淆或设置不全。比如只配了PATH却漏掉JAVA_HOME，导致Maven、Tomcat等工具无法识别JDK路径；又或者JAVA_HOME指向了JRE目录而非JDK安装根目录（如误设为C:\Program Files\Java\jre1.8.0_301，正确应为C:\Program Files\Java\jdk1.8.0_301）。
建议操作：
-
JAVA_HOME必须指向JDK根目录（含
bin、lib等子目录），不能带\bin -
PATH中添加
%JAVA_HOME%\bin，确保java、javac命令全局可用 - 现代JDK（8u261+）通常无需手动配置CLASSPATH，留空或删除更安全
- 配置后务必在新终端窗口运行
java -version和javac -version双验证
JDK版本与项目/工具不兼容
不是“装了就能用”。比如Spring Boot 3.x要求JDK 17+，但开发者装了JDK 8；又或者IDE（如老版IntelliJ IDEA 2019）默认使用内置JDK，未切换至系统已安装的高版本，导致编译报错Unsupported class file major version。
关键检查点：
立即学习“Java免费学习笔记（深入）”；
- 确认项目
pom.xml或build.gradle中指定的java.version与本地JDK匹配 - IDE需单独设置：IntelliJ → Project Structure → Project SDK；Eclipse → Preferences → Java → Installed JREs
- Maven用户注意
MAVEN_OPTS中是否硬编码了旧JDK路径（如-Djava.home=...） - 多版本共存时，用
java -version和where java（Windows）或which java（macOS/Linux）确认实际调用路径
Windows系统权限与路径空格陷阱
JDK默认安装到C:\Program Files\Java\...，其中Program Files含空格，某些脚本或旧工具（如Ant、部分Shell封装）会因未加引号解析失败，报错类似'Files\Java\jdk...' is not recognized。
稳妥做法：
- 安装JDK时自定义路径，避开空格（如
C:\dev\jdk-17） - 若已安装，可创建符号链接：
mklink /D C:\jdk C:\"Program Files"\Java\jdk-17.0.1，再让JAVA_HOME指向C:\jdk - 检查所有相关配置文件（
setenv.bat、catalina.bat、自定义启动脚本）中路径是否被双引号包裹
JRE与JDK混用导致编译失败
仅安装JRE（Java Runtime Environment）后，java命令可用，但javac命令不存在——因为编译器javac.exe只存在于JDK中。新手常误以为“能运行Java程序=环境搭好”，结果在IDE里新建类就报Cannot resolve symbol 'String'或javac command not found。
快速判断与解决：
- 执行
where javac（Windows）或which javac（macOS/Linux），无输出即未装JDK - 访问
https://adoptium.net/或https://www.oracle.com/java/technologies/downloads/下载JDK（注意选含JDK字样的安装包，非JRE） - 卸载残留JRE（控制面板→程序和功能），避免PATH中出现JRE路径优先于JDK
