JAVA_HOME配置错误主要表现为路径含中文/空格、指向JRE而非JDK、Windows缺双引号、Linux/macOS shell配置未生效；需确保JAVA_HOME指向JDK根目录，PATH中JDK/bin在前，且IDE、Maven等各层级配置一致并单独验证。
JAVA_HOME 配置错误导致 java -version 报错或识别不到 JDK
最常见的是路径中包含中文、空格，或指向了 JRE 而非 JDK。Windows 下还容易漏掉双引号（尤其路径含空格时），Linux/macOS 则常因权限或 shell 配置文件（~/.bashrc vs ~/.zshrc）未生效。
- 确认
JAVA_HOME指向的是 JDK 安装根目录（如C:\Program Files\Java\jdk-17.0.1或/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），不是jre子目录 - Windows 建议用短路径（如
C:\jdk17）或加英文双引号；Linux/macOS 执行source ~/.zshrc（或对应 shell 文件）后验证echo $JAVA_HOME -
java -version和javac -version必须输出一致的版本号，否则说明PATH中混入了其他 Java 可执行文件
PATH 里重复或错序引发 javac 不可用但 java 可用
典型现象是能运行 class 文件，但编译时报 'javac' is not recognized（Windows）或 command not found: javac（macOS/Linux）。本质是 PATH 中先匹配到了 JRE 的 bin（只有 java），而没走到 JDK 的 bin（含 javac）。
- 检查
PATH中是否同时存在 JRE 和 JDK 的bin路径；删掉 JRE 的那条（如C:\Program Files\Java\jre1.8.0_301\bin） - 确保 JDK 的
bin在 PATH 中靠前位置（Windows 系统变量里可拖动调整顺序；Linux/macOS 在export PATH=...:$JAVA_HOME/bin:$PATH中把$JAVA_HOME/bin放最前） - 终端重启后运行
which javac（macOS/Linux）或where javac（Windows）确认调用来源
IDE（IntelliJ/Eclipse）里显示“Project SDK is not defined”或编译器版本不匹配
IDE 自带的项目配置和系统环境变量是两套逻辑。即使 java -version 正确，IDE 仍可能用内置默认 JDK 或旧版本，导致 Maven 编译成功但 IDE 标红、或 Lombok 等注解处理器失效。
- IntelliJ：File → Project Structure → Project → Project SDK → 点击
New...→ JDK → 选择本地 JDK 目录（不要选 JRE） - Eclipse：Preferences → Java → Installed JREs → Add → Standard VM → JRE home 填 JDK 根路径（不是
bin）→ 勾选它为默认 - 额外检查模块级别：IntelliJ 的 Module Settings、Eclipse 的 Project Properties → Java Build Path → Libraries → 确认使用的 JRE System Library 是你刚配的 JDK
Maven 项目里 mvn compile 失败，报 Unsupported class file major version
这是 JDK 版本与 Maven 插件（尤其是 maven-compiler-plugin）或 Maven 自身要求不兼容的典型错误。比如用 JDK 21 编译，但 Maven 还在用老插件默认目标字节码版本（如 1.8）。
立即学习“Java免费学习笔记（深入）”；
- 先查 Maven 版本：
mvn -v，确认其支持的 JDK 范围（Maven 3.9+ 才完整支持 JDK 21） - 在
pom.xml中显式声明编译插件版本和源码/目标版本：org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17 - 避免只改
source不同步target，也别写成21却用 Maven 3.8.x —— 版本错配会直接中断构建
java -version。 
