ClassNotFoundException是受检异常，发生在类加载的加载阶段，代码主动通过Class.forName等查找类但未找到；NoClassDefFoundError是错误，发生在初始化后首次使用阶段，类曾成功加载但因依赖初始化失败而被JVM标记为不可用。
直接看报错类型和触发动作就能区分：ClassNotFoundException 是代码主动找类但没找到；NoClassDefFoundError 是类之前加载过，用的时候因依赖初始化失败而“失联”。
看异常类型和能否捕获
ClassNotFoundException 继承自 Exception，是受检异常，必须 try-catch 或 throws；NoClassDefFoundError 继承自 Error，属于 JVM 错误，程序无法也不该捕获，通常会导致线程中断或进程退出。
这意味着：你能在日志里看到 ClassNotFoundException 并做兜底处理；而 NoClassDefFoundError 一出现，基本说明运行环境已处于不一致状态，得回溯初始化过程。
看发生在类加载的哪个阶段
ClassNotFoundException 出现在“加载阶段”——JVM 还没开始解析字节码，只是根据类名去 classpath 或 module-path 里翻包，结果空手而归。
NoClassDefFoundError 出现在“初始化后首次使用阶段”——类文件已被成功加载、验证、准备，甚至静态字段都分配了内存，但在执行 ExceptionInInitializerError），JVM 就把该类标记为“初始化失败”，后续任何引用都会触发此错误。
- 典型表现：第一次 new 某个类时抛
ExceptionInInitializerError；第二次再 new，就报NoClassDefFoundError - 注意堆栈：NoClassDefFoundError 的堆栈顶部往往不显示根本原因，需往上翻几屏找最早的
ExceptionInInitializerError或RuntimeException
看典型触发代码模式
ClassNotFoundException 常见于显式反射调用：
Class.forName("com.mysql.cj.jdbc.Driver")Thread.currentThread().getContextClassLoader().loadClass("xxx.Service")- Spring 动态注册 Bean、MyBatis 加载 TypeHandler
NoClassDefFoundError 多出现在隐式使用场景：
-
new SomeService()（SomeService 静态块里读配置失败） -
SomeUtil.doWork()（SomeUtil 依赖的 ConfigHelper 初始化出错） - 访问某个类的静态常量，如
LogConstants.LOG_LEVEL
看排查方向是否一致
遇到 ClassNotFoundException，重点查：
- jar 包是否在 classpath 中（注意：不是 lib 目录放了就算，要看实际生效的 classpath）
- 类名拼写、大小写、包路径是否完全匹配
- 是否涉及模块化（Java 9+）：模块是否 exports 包？是否 uses/service 提供方？
遇到 NoClassDefFoundError，重点查：
- 报错类自身或其任意依赖类的静态初始化块、static 字段赋值语句
- 是否有
ExceptionInInitializerError被吞掉或未打印完整 - 类路径中是否存在同名但版本/实现冲突的 jar（例如两个不同版本的 guava，导致某类签名不兼容）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
