ClassNotFoundException 是类加载前未找到字节码，属检查异常；NoClassDefFoundError 是类已加载但初始化失败后被标记不可用，属错误。两者分别发生在加载阶段和初始化阶段。
ClassNotFoundException 是类根本没找到
这是 ClassLoader.loadClass() 找不到指定类名时抛出的检查异常，通常发生在显式加载类的场景里，比如 Class.forName("com.example.MyService") 或反射调用、JDBC 驱动注册、Spring 的动态类加载等。
常见错误现象：java.lang.ClassNotFoundException: com.example.MyService，但项目里明明有这个类——大概率是类路径（classpath）没包含对应 JAR，或打包时漏掉了该类，或用了错误的类加载器（比如在 Web 应用中用 Thread.currentThread().getContextClassLoader() 加载失败，而实际该类在 WEB-INF/lib 下，需用 WebAppClassLoader）。
- 它只发生在「主动加载」阶段：
loadClass、forName、getResource等 - 不是运行时逻辑错误，而是资源缺失问题，编译期完全无法发现
- 在模块化（Java 9+）环境下，还可能是模块未导出（
exports）或未打开（opens）包
NoClassDefFoundError 是类曾存在但初始化失败了
这是 Error，不是 Exception，意味着 JVM 在某个类首次被主动使用（比如创建实例、访问静态字段、调用静态方法）时，尝试加载并初始化它，却在「链接」或「初始化」阶段失败了——最常见的是该类依赖的另一个类在静态初始化块中抛出了未捕获异常（如 NullPointerException 或 ExceptionInInitializerError），导致类加载被中止，后续再引用它就会触发 NoClassDefFoundError。
典型错误信息：java.lang.NoClassDefFoundError: com/example/MyService，注意没有 “Exception” 后缀；堆栈里往往看不到直接原因，得往上翻——真正的问题藏在之前的 ExceptionInInitializerError 或更早的 RuntimeException 里。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 它不表示类文件丢失，而是“曾经加载过，但初始化失败后被 JVM 标记为不可用”
- 同一个类，第一次触发时报
ExceptionInInitializerError，第二次再用就报NoClassDefFoundError - 容易误判为包冲突或版本问题，其实根源常在静态代码块、
static字段赋值或static初始化器里
怎么快速定位到底是哪个环节断了
别只盯着报错行，要查完整日志流，尤其关注报错前几秒内是否出现过其他 Exception 或 Error。JVM 类加载过程分加载 → 链接（验证、准备、解析）→ 初始化，两者失败位置不同：
-
ClassNotFoundException：停在「加载」前，连字节码都没读到 -
NoClassDefFoundError：已成功加载字节码，但在「初始化」阶段崩溃，且崩溃后该类对当前类加载器永久失效
实操建议：
- 用
-verbose:classJVM 参数观察类加载顺序和来源（比如[Loaded com.example.MyService from file:/app/lib/my-service.jar]） - 在 IDE 中对疑似类的
static块加断点，或用java -XX:+TraceClassLoadingPreorder辅助分析依赖链 - Maven 项目里检查
mvn dependency:tree -Dverbose是否存在同名类被多个依赖引入，且版本/签名不一致
Spring Boot 场景下特别容易混淆的点
Spring 的自动配置、条件化加载（@ConditionalOnClass）和启动类扫描会掩盖底层类加载行为。比如你写了 @ConditionalOnClass(NettyReactiveWebServerFactory.class)，但实际项目没引 Netty 相关依赖——这时 Spring 不会报 ClassNotFoundException，而是跳过该配置；但如果某处代码在非条件保护下直接 new 了这个类，才会真正触发异常。
-
ClassNotFoundException多出现在手动Class.forName或第三方库内部反射调用中（如 MyBatis 的类型处理器注册） -
NoClassDefFoundError更常出现在 Bean 初始化阶段，尤其是带@PostConstruct或构造器中调用了静态工具类的场景 - 使用
spring-boot-devtools时，热重载可能让类加载器状态不一致，导致偶发NoClassDefFoundError，重启应用常能复现真实问题
最麻烦的情况是：错误堆栈里只显示 NoClassDefFoundError，但初始化失败的源头在另一个被 try-catch 吞掉异常的静态块里——这种必须靠日志或调试确认初始化路径，不能只信最后一行报错。
