noclassdeffounderror 是 jvm 链接阶段失败的 error,不可恢复;classnotfoundexception 是反射显式加载失败的受检 exception。前者源于隐式加载(如 new、静态访问)时类缺失或初始化失败,后者仅发生于 class.forname() 等显式调用且类名错误或 classpath 缺失。

这两个看起来很像,其实根本不是一类东西:一个是 Error,一个是 Exception;一个属于系统级故障,一个属于可预期、可捕获的运行时问题。
本质类型不同
NoClassDefFoundError 继承自 Error,是 JVM 在链接阶段失败时抛出的严重错误,程序通常无法恢复,也不建议 try-catch;
ClassNotFoundException 继承自 Exception(更准确说是 ReflectiveOperationException),是受检异常,必须显式处理或声明抛出。
触发时机和方式不同
它们背后反映的是两类类加载行为:
-
NoClassDefFoundError 发生在 隐式加载 过程中——比如用
new A()、调用 A 的静态方法、访问 A 的静态字段,或 JVM 自动解析依赖类时。前提是:A 类在编译时存在且被成功引用,但运行时找不到其 class 文件(如被删、路径缺失、jar 没打包进去),或 A 的静态初始化块抛了未捕获异常导致类加载中止。 -
ClassNotFoundException 发生在 显式反射加载 过程中——只出现在调用
Class.forName()、ClassLoader.loadClass()或ClassLoader.findSystemClass()时,且传入的类名拼错、类不在 classpath、对应 jar 未引入等。
典型场景对比
举两个直观例子:
- 你写了
A a = new A();,编译通过,但运行前手动删了A.class→ 启动时执行到这行就报 NoClassDefFoundError。 - 你写了
Class.forName("com.example.MissingClass"),而这个类压根不存在或没加依赖 → 执行到这行就抛 ClassNotFoundException。 - 再比如:A 类有个 static { throw new RuntimeException(); },第一次用 A 时会先触发初始化失败(抛 ExceptionInInitializerError),之后再访问 A 就会报 NoClassDefFoundError ——注意这不是找不到类,而是“类曾加载失败,JVM 拒绝重试”。
排查重点不一样
遇到前者,优先检查:
- 运行时 classpath 是否完整(尤其多模块项目中 jar 是否漏打包)
- 是否有
ExceptionInInitializerError被吞掉(它常是 NoClassDefFoundError 的真正原因) - 是否用了不同的类加载器(如 Web 容器里 common / webapp 类加载器隔离)
遇到后者,直接看:
- 传给
forName()的字符串对不对(包名、大小写、是否带 .class) - 对应类所在的 jar 是否在运行 classpath 中(可用
-verbose:class观察加载过程) - 是否混淆/裁剪工具误删了该类(如 ProGuard、R8)










