AnnotationFormatError是Error子类，非运行时异常，发生在JVM加载类或反射解析注解元数据时，源于字节码中注解结构损坏（如枚举悬空、Class引用不可达），属构建期缺陷信号，不建议捕获，需通过javap分析、构建校验和环境一致性修复。
AnnotationFormatError 不是运行时异常，而是 Error 子类，发生在类加载或反射解析注解元数据阶段，属于 JVM 层面的严重元数据损坏信号；而运行时异常（RuntimeException）是 Exception 的子类，由程序逻辑错误触发，可被捕获、可恢复，且在方法调用执行过程中抛出。
发生时机与触发阶段不同
AnnotationFormatError 出现在两个关键节点之一：
- JVM 加载 class 文件时，校验 RuntimeVisibleAnnotations 属性中的注解字节码结构（如默认值类型错位、枚举常量悬空、Class 引用不可达），此时类尚未初始化，甚至还未进入 main 方法
- 首次通过反射访问注解时（如
clazz.getAnnotation(MyAnno.class)），JVM 解析注解常量池失败，而非在业务代码执行中途“算错数”或“空指针”
运行时异常则严格发生在 Java 字节码指令执行流中：比如数组越界发生在 array[i] 执行时，空指针发生在 obj.toString() 调用前发现 obj 为 null，属于程序动态行为的直接后果。
继承体系与设计意图根本不同
AnnotationFormatError 继承自 Error，和 OutOfMemoryError、LinkageError 同级：
立即学习“Java免费学习笔记（深入）”；
- 表示 JVM 自身元数据完整性被破坏，不是开发者能“修复”的逻辑问题，而是 class 文件已损坏、混淆失当、JDK 版本不兼容等构建期缺陷的暴露
- 规范明确不建议捕获——catch 它无法重建合法注解结构，仅能记录日志或降级，掩盖真实构建问题
运行时异常继承自 RuntimeException，属于 Exception 分支：
- 代表程序在正常运行路径中出现了可预期的逻辑偏差（如参数非法、状态不一致）
- 允许且鼓励按需捕获处理，例如 try-catch
IllegalArgumentException并返回友好提示
是否受编译检查与传播方式不同
AnnotationFormatError 完全绕过 javac 编译检查：
- 源码写法完全合法，
@MyAnno(value = "ok")在编译期毫无问题 - 错误只在 class 文件生成后被破坏（如 Maven 增量编译残留、ProGuard 误删注解属性、fat jar 多版本 class 冲突）才暴露
运行时异常虽也不强制声明，但其触发条件往往可被静态分析识别：
- 像
NullPointerException可通过 IDE 提示、SpotBugs 检测潜在空引用 - 抛出动作本身是显式或隐式字节码指令（如
athrow），有明确执行栈上下文
排查路径和修复主体完全不同
遇到 AnnotationFormatError，你要查的是构建产物和环境：
- 用
javap -verbose MyClass.class | grep -A 20 "RuntimeVisibleAnnotations"直接看字节码里注解常量池是否含非法类型标签或悬空索引 - 检查是否混用 JDK 8 编译的注解与 JDK 17 运行环境（新版本校验更严）
- 确认 Lombok/MapStruct 等注解处理器是否完整输出了注解相关字节码
遇到运行时异常，你要查的是代码逻辑和输入数据：
- 看堆栈定位到具体哪行执行语句崩溃，结合变量值判断原因
- 补充判空、范围检查、状态校验等防护逻辑
- 可通过单元测试覆盖边界场景提前暴露
