使用 -verbose:class 可直接查看每个类的加载器和路径,有效排查 Jar 包混杂导致的类冲突;启动时添加该 JVM 参数即可,在控制台输出中重点比对类名、来源路径和加载时机,并结合 getClassLoader() 打印确认加载器实例。

用 -verbose:class 能直接看到每个类由哪个加载器、从哪条路径加载,对排查 Jar 包混杂导致的类冲突(比如同名类被不同模块加载、ClassCastException、静态字段不一致)非常有效。
怎么开启并读取 -verbose:class 输出
在启动 JVM 时添加参数即可,无需改代码:
- 命令行:
java -verbose:class -jar your-app.jar - IDEA:打开 Run → Edit Configurations → VM options,填入
-verbose:class - Eclipse/MyEclipse:右键项目 → Run As → Run Configurations → Arguments → VM arguments,添加该参数
运行后控制台会逐行打印类似这样的日志:
[Loaded com.example.UserService from file:/app/lib/core-module.jar][Loaded com.example.UserService from file:/app/lib/legacy-api.jar]
注意这两行——同一个全限定名却来自不同 jar,就是冲突根源。
重点看三类关键信息
每条日志隐含三层线索,调试时要同步比对:
-
类名是否完全一致:包括包名、大小写、是否带内部类符号(如
$)。例如com.foo.Config和com.foo.config是两个类 - 来源路径是否预期:确认加载的是你期望的 jar(比如 Spring Boot 的 starter,而不是旧版依赖传递进来的同名类)
- 加载时机是否异常:如果某个类在应用初始化前就被加载(比如由 Tomcat 启动时提前加载),可能绕过了 Spring 的条件化配置逻辑
结合 ClassLoader 打印定位真实归属
仅靠 -verbose:class 有时不够,因为日志不显示加载器实例。可在关键位置补一行诊断代码:
System.out.println(UserService.class + " loaded by " + UserService.class.getClassLoader());
输出类似:
class com.example.UserService loaded by org.springframework.boot.loader.LaunchedURLClassLoader@12345678
再对照 -verbose:class 日志里同一类的加载路径,就能确认是不是“路径对、加载器错”——比如本该由应用类加载器加载,却被 Extension 类加载器提前锁定了。
常见干扰与绕过技巧
有些场景下 -verbose:class 日志会被淹没或延迟显示:
- 日志量太大?加
2>&1 | grep "YourClassName"过滤(Linux/macOS);Windows 可用findstr - Spring Boot Fat Jar 中类路径是
jar:file:/xxx.jar!/BOOT-INF/classes!/格式,注意识别真实 jar 名(看!/"前的部分) - 热部署(如 DevTools)会导致重复加载,观察是否有同一类被多次
[Loaded ...]——说明类加载器未卸载干净 - 想确认是否被 Bootstrap 加载?看日志中是否出现
shared objects或路径含rt.jar、modules(JDK9+)

















