Java环境问题主因是JDK版本不匹配、依赖冲突、调试信息缺失及JAVA_HOME配置错误；需统一编译与运行版本、排查依赖树、启用调试选项、确保JAVA_HOME指向完整JDK。

Java版本不匹配导致编译失败或运行异常

IDE（如IntelliJ或Eclipse）中显示 Unsupported class file major version，或Maven编译时提示 java.lang.UnsupportedClassVersionError，基本是JDK版本不一致：源码用高版本JDK编译，却在低版本JRE上运行。

• 检查项目配置：IDEA中确认 Project SDK 和 Project language level 一致，且与 Settings > Build > Compiler > Java Compiler > Target bytecode version 匹配
• Maven项目需同步设置 maven-compiler-plugin 的 source 和 target（或 release），例如：

  <configuration>
    <source>17</source>
    <target>17</target>
  </configuration>

• 命令行执行前，用 java -version 和 javac -version 分别验证运行时和编译器版本；两者应指向同一JDK安装路径

CLASSPATH混乱引发NoClassDefFoundError或NoSuchMethodError

这类错误常不是类没找到，而是类加载时因依赖冲突、版本错位或静态初始化失败而抛出——尤其在Spring Boot或模块化项目中更隐蔽。

• 用 mvn dependency:tree -Dverbose 查看实际参与编译的依赖树，重点找重复引入或版本不兼容的包（如两个不同版本的 guava）
• 排除冲突依赖：在 pom.xml 中对问题依赖添加 <exclusions>，例如排除传递引入的旧版 slf4j-api
• 启动时加 -verbose:class 参数，观察JVM实际加载了哪些类及其来源路径，可快速定位是否加载了错误jar

IDE调试时断点不生效或变量无法解析

常见于启用Lombok、使用record、或启用了Java模块系统（module-info.java）的项目，本质是调试信息（debug info）缺失或被优化掉。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 确认编译选项包含 -g（生成全部调试信息），Maven中对应 maven-compiler-plugin 的 debug 设为 true
• Lombok项目必须安装对应IDE插件，并开启 Enable annotation processing；否则生成的getter/setter不会出现在字节码调试视图中
• 若用Java 9+模块系统，确保 module-info.java 中导出了含调试类的包（exports com.example.debug），否则IDE可能无法访问私有字段

环境变量与工具链混用导致mvn/jps/jstack失效

执行 mvn clean 报错找不到 tools.jar，或 jps 列不出本地Java进程，多因 JAVA_HOME 指向JRE而非JDK，或PATH中混入了不同厂商/版本的Java二进制路径。

立即学习“Java免费学习笔记（深入）”；

• Windows下检查 %JAVA_HOME%\bin\javac.exe 是否存在；Linux/macOS执行 ls $JAVA_HOME/bin/javac，不存在即说明 JAVA_HOME 配错了
• 运行 which java 和 which javac，二者输出路径应同属一个JDK目录；若不同，清理PATH中冗余的Java路径，只保留JDK的 bin 目录
• 某些OpenJDK发行版（如Zulu、Temurin）不带 tools.jar，但 jps/jstack 已内置，无需额外配置——只要 java -version 输出含 JDK 字样即可

Java环境排错最耗时的往往不是错误本身，而是多个配置层（系统变量、IDE设置、构建工具、容器启动脚本）之间隐性覆盖。建议每次变更后，用 java -XshowSettings:properties -version 确认JVM实际读取的环境参数，比凭经验猜快得多。