OpenJDK报ClassNotFoundException怎么排查

星涛君_6868

星涛君_6868

2026-10-18

111人浏览

原创

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

openjdk报classnotfoundexception怎么排查

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。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10697

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7822

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6792

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1164

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

948

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1396

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2809

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20111

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
OpenJDK项目Wiki
OpenJDK项目Wiki

共0课时 | 0人学习

OpenJDK构建指南
OpenJDK构建指南

共0课时 | 0人学习

OpenJDK官网文档
OpenJDK官网文档

共0课时 | 0人学习