NoClassDefFoundError本质是UserService类在注解解析时被强制初始化失败，其静态块或字段初始化抛出未捕获异常（如ClassNotFoundException），导致JVM标记该类初始化失败，后续访问均抛此错误；根因需查ExceptionInInitializerError的cause。
注解属性里声明了
类型（比如
），运行时反射读取该注解却抛出
，本质不是注解本身没加载，而是它引用的
在当前类加载器下无法初始化——这是个典型但容易被忽略的“间接类加载失败”问题。
注解里的 Class 属性会触发目标类的主动初始化
Java 规范规定：当注解属性是
类型时，JVM 在解析该注解（例如调用
）时，**必须解析并初始化其值所指向的类**。这不是简单的符号引用，而是强制触发
的静态初始化阶段。
如果
的
块或静态字段初始化过程中抛出了未捕获异常（如内部依赖的某个类缺失），JVM 会标记该类为“初始化失败”，后续任何对该类的使用（包括 new、反射、甚至再次读取同一注解）都会直接抛出
。
常见诱因包括：
的静态块里调用了另一个不存在的类（如
），而对应 jar 缺失
该类依赖的某个第三方类在运行时被排除（如 Maven 中 scope=provided，但部署环境未提供）
类由不同类加载器加载，且父加载器无法委派到子加载器中的类（尤其在 Web 容器或 OSGi 环境）
排查关键：先看 ExceptionInInitializerError
往往是“果”，真正原因藏在它包裹的“因”里。务必检查完整堆栈——90% 以上情况，它的 cause 是
，而这个 error 的 cause 才是真正的根因（比如
或
自身）。
示例堆栈片段：
Caused by: java.lang.NoClassDefFoundError: com/example/DependOnMeat com.example.UserService.(UserService.java:12)Caused by: java.lang.ExceptionInInitializerError... 1 moreCaused by: java.lang.ClassNotFoundException: com.example.DependOnMe
此时应聚焦
是否在运行时 classpath 中，而不是纠结
或注解本身。
避免注解中硬编码 Class 引用的替代方案
若业务允许，可绕过 Class 类型属性的强初始化约束：
改用字符串全限定名（
），在真正需要时再用
加载，并自行处理
使用延迟初始化：注解只存标识符，实际类加载推迟到业务逻辑中首次使用时，便于捕获和降级
确保所有被
属性引用的类，其所有静态依赖都已就位；可在单元测试中模拟注解读取，提前暴露初始化失败
验证类是否真的能被当前类加载器加载
在出问题的位置附近，加一行调试代码：
System.out.println(MyAnno.class.getClassLoader().loadClass("com.example.UserService"));
如果这行也报错，说明问题不在注解机制，而在类加载路径或隔离本身。重点检查：
该类是否被打包进最终产物（jar/war）？Maven 依赖是否为 compile 范围？
运行时使用的类加载器（如 Tomcat 的 WebAppClassLoader）能否访问到该类？是否被容器 lib 隔离？
JDK 版本兼容性：该类是否由高版本 JDK 编译，而运行环境 JDK 过低？
Class@MyAnno(value = UserService.class)NoClassDefFoundErrorUserService.classClassmethod.getAnnotation(MyAnno.class)UserServiceUserServicestatic {}NoClassDefFoundErrorUserServiceorg.apache.commons.lang3.StringUtilsNoClassDefFoundErrorExceptionInInitializerErrorClassNotFoundExceptionNoClassDefFoundErrorDependOnMeUserServiceString value() default "com.example.UserService"Class.forName(name)ClassNotFoundExceptionClass