classnotfoundexception本质是类加载环境错配:jvm按双亲委派模型查找类,但目标类未出现在当前线程上下文类加载器的classpath中,需重点排查“谁在加载、从哪加载、加载了啥”,而非jdk版本问题。

OpenJDK 报 ClassNotFoundException,不是 JDK 本身有问题,而是你的类加载环境没对上——JVM 按双亲委派模型找类,但目标类压根没进它的视野。排查重点不在 JDK 版本,而在“谁在加载、从哪加载、加载了啥”。
看报错栈顶那行 at org.example.Main.main(Main.java:12)
这行是关键线索:它告诉你异常触发点是 Main.main 的第 12 行。打开这个文件,定位那一行代码,大概率是类似这样的调用:
Class.forName("org.apache.commons.codec.binary.Base64")Thread.currentThread().getContextClassLoader().loadClass("com.mysql.cj.jdbc.Driver")-
SpringApplication.run(...)内部反射加载某个 starter 类
只要出现字符串形式的类名传参,就属于动态加载场景。此时 JVM 会严格按当前线程的上下文类加载器(Thread.currentThread().getContextClassLoader())去查 classpath,而不是你 IDE 里看到的编译路径。
检查运行时实际 classpath 是否包含目标类
别信 IDE 或 pom.xml 里写了就等于能用。得看 JVM 启动时真正看到的是什么:
- 如果是
java -jar app.jar,执行jar -tf app.jar | grep Base64,确认org/apache/commons/codec/binary/Base64.class是否真在里面 - 如果是
java -cp lib/*:classes/ Main,先用echo $CLASSPATH(Linux/Mac)或echo %CLASSPATH%(Windows)看变量值,再手动检查每个路径下是否存在对应.class或.jar - 加启动参数
-verbose:class,JVM 会打印所有被加载的类及其来源,搜Base64看有没有加载记录;没打印 = 没找到,打印了但后面抛异常 = 可能是NoClassDefFoundError或链接失败
注意 OpenJDK 与类加载器行为的隐性差异
OpenJDK 和 Oracle JDK 在类加载逻辑上基本一致,但某些版本(如 OpenJDK 17+)对模块系统(JPMS)更严格,容易暴露老项目里的隐患:
- 如果你用了
--module-path或module-info.java,但依赖的第三方 JAR 没声明requires,JVM 可能拒绝加载其内部类,表现为ClassNotFoundException - OpenJDK 11+ 默认启用
--illegal-access=deny,若代码通过反射访问非公开类(比如某些旧版 JDBC 驱动),也会伪装成类找不到 - 某些构建插件(如
spring-boot-maven-plugin)在 OpenJDK 下打包时,若未显式配置includeSystemScope=true,可能漏掉system范围的依赖(如本地ojdbc8.jar)
别跳过线程上下文类加载器这个“隐身开关”
尤其在异步、框架集成、自定义 ClassLoader 场景下,Thread.currentThread().getContextClassLoader() 往往和你预期的不一样:
-
CompletableFuture.runAsync()默认走ForkJoinPool.commonPool(),该池中线程的上下文类加载器通常是AppClassLoader,但若主线程改过它(比如 Spring Boot DevTools 会设为RestartClassLoader),子线程不会自动继承 - Tomcat、Jetty 等容器会为每个 WebApp 设置独立的
WebAppClassLoader,但如果你在 Servlet 中启了个新线程又没手动设置上下文类加载器,新线程就会回退到SystemClassLoader,导致找不到 WEB-INF/lib 下的类 - 解决方案很简单:在任务开始前显式设置,例如
Runnable task = () -> { Thread.currentThread().setContextClassLoader(getClass().getClassLoader()); /* your logic */ };
最常被忽略的,是认为“打包进 fat jar 就万事大吉”,却没验证类是否真的在 jar 包内、是否被 shade 插件重命名、是否因 Maven scope(如 test 或 provided)被排除——这些细节一漏,OpenJDK 就只是个冷静的旁观者,照常抛出 ClassNotFoundException。











