JDK版本冲突的典型场景与解决思路
刚下载的OpenJDK 11编译时报UnsupportedClassVersionError？八成是项目里混用了不同版本的JDK。这种情况在同时维护多个老项目时特别常见，比如Spring 4.x要求JDK 8，而新开发的模块用了JDK 17的特性。最彻底的解决方案是：
java -version和javac -version双重验证环境变量maven-compiler-plugin显式指定source和target版本
org.apache.maven.plugins
maven-compiler-plugin
3.8.1
11
11
依赖地狱的破局方法
Maven的Could not resolve dependencies报错就像俄罗斯套娃，经常是A依赖B，B又依赖C的1.0版，但项目里已经用了C的2.0版。这时候光看报错信息根本找不到北，得用这些招数：
mvn dependency:tree -Dverbose 查看完整的依赖树Exclude排除传递性依赖| 问题现象 | 排查命令 | 解决方案 |
|---|---|---|
| NoClassDefFoundError | mvn clean install -X | 检查optional依赖是否漏引 |
| MethodNotFoundError | javap -verbose 类名 | 确认字节码版本匹配 |
调试环境配置的隐藏技巧
用IntelliJ调试JDK源码时，默认只能看到反编译的class文件。要看到真正的JDK源码需要：
碰到Native方法调试就更有意思了。比如想跟踪HashMap的putVal()方法，得先：
-XX:+PrintAssembly构建工具的特殊配置
Gradle构建Spring源码时经常卡在compileJava阶段？试试在gradle.properties里加上：
org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g
org.gradle.parallel=true
org.gradle.caching=true
Ant项目遇到javac: invalid target release时，要检查build.xml里这两个参数是否一致：
调试JDK源码时看不到变量值这事儿，很多开发者第一次接触时都会懵。其实这是因为Oracle/Sun官方发布的JDK为了优化性能，默认把调试信息给精简了，特别是那些内部类的变量信息基本都被裁剪掉了。要解决这个问题，得先去Oracle官网下载和你当前JDK版本完全匹配的src.zip源码包，然后在IntelliJ IDEA里通过Project Structure→Platform Settings→SDKs把源码路径关联上。光这样还不够，记得在Run/Debug Configurations的VM options里加上-XX:+DebugNonSafepoints这个关键参数，不然调试时还是只能看到反编译的class文件。
如果是要调试HotSpot虚拟机的核心代码，比如想跟踪HashMap的resize()方法具体实现，事情就更复杂些。除了上述操作，还得在启动参数里加上一堆add-exports=java.base/sun.security.x509=ALL-UNNAMED这样的模块导出声明。这是因为从JDK 9开始引入的模块化系统，把很多内部API都给隐藏起来了。 直接在IDEA的模板配置里永久添加这些参数，否则每次新建调试配置都得重新输入。有时候还会遇到行号对不上的情况，这时候可以试试用GraalVM提供的debuginfo版本JDK，它保留了完整的调试符号信息。
常见问题解答
为什么明明安装了JDK 11却提示UnsupportedClassVersionError？
这通常是因为编译环境和运行环境的JDK版本不一致导致的。比如用JDK 8编译的class文件放到JDK 11环境下运行不会报错，但反过来就会触发这个错误。 检查IDE、Maven/Gradle配置和系统环境变量中的JAVA_HOME是否都指向相同版本的JDK。
Maven依赖冲突时如何快速定位问题根源？
最有效的方法是使用mvn dependency:tree -Dverbose命令查看完整的依赖树，其中会标注冲突的依赖项。对于特定报错，可以尝试在IDEA的Maven工具窗口右键选择”Show Dependencies”生成可视化依赖图，红色连线表示冲突关系。
调试JDK源码时为什么看不到变量值？
默认情况下JDK的调试信息是被裁剪过的。需要下载对应版本的JDK源码包并关联到IDE，同时在启动配置中添加JVM参数-XX:+DebugNonSafepoints。对于HotSpot虚拟机源码调试，还需要额外配置add-exports参数开放内部模块。
Gradle构建大型Java项目时内存不足怎么办？
在gradle.properties中调整JVM参数，例如设置org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g。对于包含100+模块的项目，可以启用构建缓存(org.gradle.caching=true)和并行编译(org.gradle.parallel=true)，构建速度能提升30%-50%。
为什么Ant项目在JDK 11-17环境下构建失败？
老版本Ant(1.9.x之前)对新JDK的支持有限。需要确保build.xml中javac任务的source/target参数与当前JDK兼容，同时检查是否有使用被移除的API。推荐升级到Ant 1.10.+版本，它对JDK 9+的模块化系统有更好支持。
