Java版本不一致导致运行时报java.lang.UnsupportedClassVersionError，因高版本编译、低版本运行；需统一JAVA_HOME、PATH、IDE及Maven配置，并避免中文路径与环境变量污染。
Java版本不一致导致编译通过但运行报错
常见现象是 javac 编译成功，运行时抛出 java.lang.UnsupportedClassVersionError。根本原因是源码用高版本 JDK 编译（如 JDK 17），但 JAVA_HOME 指向低版本 JRE（如 JDK 8）执行。
- 检查当前使用版本：
java -version && javac -version
，二者输出必须一致 - 不要只改
PATH，务必同步设置JAVA_HOME指向同一 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home） - IDE（如 IntelliJ）需单独配置：Project Settings → Project SDK 和 Project language level 必须匹配本地
JAVA_HOME - 若用 Maven，确认
pom.xml中maven-compiler-plugin的source和target与 JDK 版本兼容（JDK 17 不支持target="1.8"）
IDEA中Maven依赖下载失败或识别不到
不是网络问题，而是本地 Maven 配置未被 IDE 正确加载，表现为 import 报红、mvn compile 成功但 IDEA 显示 unresolved symbol。
- 确认 IDEA 使用的是你本地安装的 Maven（而非内置 bundled Maven）：Settings → Build → Build Tools → Maven → Maven home path
- 强制刷新：右键项目 →
Maven → Reload，或点击右侧 Maven 工具栏的Reload project图标 - 检查
~/.m2/settings.xml是否配置了镜像（如阿里云），但路径写错或标签闭合不全会导致整个文件失效 - 若用公司 Nexus 私服，确保
settings.xml中id与
Windows下中文路径引发javac乱码或找不到类
当项目路径含中文（如 C:\用户\张三\workspace\hello），javac 可能将源文件名解析为乱码，导致 cannot find symbol 或 encoding GBK not supported 错误。
- 最彻底解法：把项目移到纯英文路径下（如
C:\dev\hello） - 临时绕过：在命令行中显式指定编码：
javac -encoding UTF-8 Hello.java
，并确保源文件本身保存为 UTF-8（无 BOM） - IDEA 用户需额外检查：Settings → Editor → File Encodings → Global Encoding / Project Encoding / Default encoding for properties files 全部设为
UTF-8，且勾选Transparent native-to-ascii conversion（尤其对.properties文件）
环境变量污染导致工具链行为异常
JAVA_HOME、PATH、MAVEN_HOME 多处定义（如系统变量 vs 用户变量 vs shell profile），容易造成命令实际调用的不是你以为的那个程序。
立即学习“Java免费学习笔记（深入）”；
- 在终端执行：
which java && which javac && which mvn
，再对比echo $JAVA_HOME
，三者指向必须逻辑自洽 - Windows 用户注意：PowerShell 和 CMD 的环境变量可能不同，IDEA 默认继承的是系统启动时的环境（常为 CMD 值），建议统一在系统属性中设置
- Mac/Linux 用户检查
~/.zshrc、~/.bash_profile、/etc/profile是否重复 export 同一变量，后加载的会覆盖前一个 - 用
java -XshowSettings:properties -version查看 JVM 实际读取的java.home，这是最权威的依据
export JAVA_HOME 写错路径后没重启终端，或是 IDEA 没 reload Maven，又或是 Windows 下用了带空格的用户名——这些细节不报错，只让一切“看起来差不多”，却死活跑不通。 
