MirroredTypeException 是注解处理器因引用类未加载或不可见而抛出的编译期异常；需通过 TypeMirror 和 Types/Elements 工具安全操作类型，避免强转 Class，并容错处理不可见类型。
mirroredtypeexception
是
java
注解处理过程中一个典型的编译期异常，它发生在注解
处理器
尝试通过
获取某个注解元素（如
）的
类型值，但该类在当前注解处理阶段尚未被加载或不可见时。
为什么会出现 MirroredTypeException
Java 编译器在处理注解时，并不会主动加载被引用的类（尤其是尚未编译完成、位于同一模块但未被处理的类，或仅存在于源码中未生成 class 文件的类）。此时调用
返回的是一个
，但若错误地强制转换为
或调用其
以外的反射方法（如
前未校验），就可能触发
。
常见触发代码：
❌ 错误示例：
正确读取未加载类的类型信息
应始终通过
和
/
工具类操作，避免直接转
：
使用
获取
（而非强转
）
通过
获取擦除后的类型（如
→
）
用
尝试解析类型元素（注意：返回 null 表示类不可见，需容错）
安全获取类名：调用
得到二进制名称（如
），再用
（如用
）或手动解析包名/简单名
捕获并降级处理 MirroredTypeException
虽然推荐全程用
，但某些旧逻辑或第三方工具可能仍会触发该异常。可在关键位置显式捕获并提供备选方案：
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
下载
立即学习
“
Java免费学习笔记（深入）
”；
在访问
后的任意反射操作前，用 try-catch 包裹
捕获
后，回退到
解析类名
记录警告日志（如
），而非中断处理
避免在 catch 块中尝试重新加载类或延迟处理——注解处理器无运行时类加载能力
预防胜于补救：设计健壮的注解 API
从源头减少异常发生概率：
注解成员尽量用
代替
，例如
，由处理器解析字符串为
若必须用
，文档明确要求该类需已编译且在 classpath 中可见（如放在独立的 api 模块）
在处理器中预先检查依赖类是否可用：
结合
和模块化路径验证，避免跨 module 引用未导出的类型
不复杂但容易忽略：MirroredTypeException 不是 bug，而是编译器对类型可见性边界的诚实反馈。用好
和环境工具类，比异常处理更重要。
annotationvalue@myanno(value = someclass.class)classannotationValue.getValue()TypeMirrorClasstoString().asElement().getSimpleName()MirroredTypeException// 假设 value() 返回 Class
Class clazz = (Class) annoElement.getAnnotationValue(); // 运行时抛 MirroredTypeExceptionTypeMirrorElementsTypesClassannotationValue.getValue()TypeMirrorClassprocessingEnv.getTypeUtils().erasure(typeMirror)ListListprocessingEnv.getElementUtils().getTypeElement(typeMirror.toString())typeMirror.toString()java.lang.StringClassName.get()javapoetTypeMirrorannotationValue.getValue()MirroredTypeExceptiontypeMirror.toString()messager.printMessage(WARNING, "Class not available yet: " + typeStr, element)StringClassString value() default "java.lang.Object"TypeMirrorClassgetElementUtils().getTypeElement("com.example.MyDep") != null@SupportedSourceVersionTypeMirror