Java注解Class属性抛出ClassNotFoundException的根本原因是JVM解析注解时类加载失败，需确保默认值类在classpath中可见、类加载器可访问、编译与运行环境一致。
当 Java 自定义注解的属性声明为 Class 类型（如 Class<?> value() default Object.class;），运行时却抛出 ClassNotFoundException，通常不是注解本身的问题，而是 JVM 在解析注解值时尝试加载指定类失败所致。关键在于：注解中写死的类名（尤其是字符串形式）或默认值引用的类，在当前类路径下不可见。
注解中使用字符串类名而非 Class 字面量
常见错误是把 Class 属性设计成 String 类型，再在运行时通过 Class.forName() 加载——这极易因类路径、类加载器隔离等问题触发 ClassNotFoundException。正确做法是直接声明为 Class<?> 类型，并在使用处传入字面量（如 @MyAnno(value = String.class)）。若必须用字符串，需确保：
- 字符串类名拼写完全正确（含包路径，区分大小写）
- 目标类在调用方的类路径（classpath）中可用
- 加载该类的类加载器（通常是当前线程上下文类加载器）能访问到该类
默认值引用的类在运行时缺失
注解属性若设了默认值（如 Class<?> value() default MyService.class;），而 MyService 所在的 jar 包未被引入或版本不匹配，JVM 解析注解元数据时就会失败。尤其在模块化（JPMS）或 OSGi 环境中更敏感。
- 检查该默认值类是否确实存在于 classpath 中（用
ClassLoader.getSystemResource("com/example/MyService.class")验证） - 避免在注解中依赖业务模块的类作为默认值；可改用
void.class或Object.class等 JDK 内置类 - 若必须用业务类，确保其 jar 被 compile scope 引入，且未被 shade 或 exclude 掉
反射读取注解时类加载器不一致
通过 clazz.getAnnotation(MyAnno.class) 获取注解后，若手动调用 annotation.value().getName() 等操作，看似安全，但某些框架（如 Spring AOP、自定义 AnnotationProcessor）会在不同类加载器上下文中解析注解值，导致目标类找不到。
立即学习“Java免费学习笔记（深入）”；
- 调试时打印
Thread.currentThread().getContextClassLoader()和MyAnno.class.getClassLoader()，确认二者能否访问目标类 - 必要时显式指定类加载器：用
Thread.currentThread().getContextClassLoader().loadClass("xxx.Yyy")替代Class.forName("xxx.Yyy") - 避免在注解处理器中直接 new 实例或调用静态方法——只做元数据提取
编译期与运行期类路径不一致
开发时 IDE 能识别类，但打包后（如 Spring Boot fat jar、war 包）类路径结构变化，或依赖被 relocation（如 Maven Shade Plugin），导致注解里写的 Class 字面量指向的类实际路径已变。
- 检查最终运行包中是否存在对应 .class 文件（
jar -tf app.jar | grep MyService） - 若用了 shading，确认
relocations规则未影响注解中引用的类 - 在构建脚本中添加验证任务：启动前用
Class.forName()主动探测关键注解默认值类
不复杂但容易忽略——核心始终是：Class 属性的值在 JVM 解析注解字节码阶段就必须能被加载，而不是等到你代码里第一次用它的时候。
