Java模块化项目中注解处理失效的根本原因是模块边界阻断可见性链，需确保处理器被编译器调用、生成逻辑注入目标类字节码、消费模块合法访问生成内容。
编译期注解处理在 Java 模块化（JPMS）项目中失效，核心不是注解写错了，而是模块边界切断了注解处理器与目标代码之间的“可见性链”。关键要打通三环：处理器能被编译器识别、生成逻辑能注入目标类字节码、消费方模块能合法访问生成内容。
确认注解处理器是否真正参与编译流程
很多项目只加了 Lombok 或自定义处理器的依赖，却没让编译器调用它。Maven 中必须明确配置 annotationProcessor 范围，不能仅靠 compile 或 provided 依赖：
- Maven 的
maven-compiler-plugin需启用<annotationProcessorPaths>，且处理器依赖 scope 必须为compile或不声明（不是runtime） - Gradle 中需同时声明：
compileOnly+annotationProcessor（如annotationProcessor 'org.projectlombok:lombok:1.18.30'） - 编译时开启日志：
<showWarnings>true</showWarnings>，观察控制台是否输出Processing @Data或类似提示
验证生成方式是否匹配模块系统要求
模块化环境下，仅生成辅助类（如 Person$$Accessor.java）是不够的——JVM 加载的是原始类的 .class，它必须**自身包含**生成的方法。否则下游模块调用 person.getName() 就会报 NoSuchMethodError：
- 用
javap -p target/classes/com/example/Person.class查看字节码，确认getName()是否真实存在 - 若只看到独立生成类，说明你走的是“源码生成”路径，应切换为字节码增强方案（如 Byte Buddy、ASM），或改用已适配 JPMS 的工具（如较新版本的 Lombok 1.18.30+）
- 避免在注解处理器中写
Filer.createSourceFile()，优先使用JavacTask或ClassWriter直接改写目标类
检查 module-info.java 的 exports/opens 是否到位
即使方法已写进字节码，模块系统仍会拦截访问。exports 控制编译期调用，opens 控制运行时反射，二者缺一不可：
立即学习“Java免费学习笔记（深入）”；
- 若生成的方法在
com.example.model包中，提供方模块的module-info.java必须写：exports com.example.model; - 若框架需反射读私有字段（如 Jackson 序列化、Spring Bean 初始化），还必须加：
opens com.example.model; - 包名必须完全一致，不支持通配符；子包不会自动被导出或开放
- 消费方模块只需
requires提供方模块名，无需额外配置
排查 IDE 和构建环境不一致问题
命令行 mvn compile 成功但 IDEA 报红，大概率是 IDE 自身未启用注解处理：
- IntelliJ IDEA：进入 Settings → Build → Compiler → Annotation Processors，勾选 Enable annotation processing 和 Obtain processors from project classpath
- 确保 Lombok 插件已安装并启用（插件市场搜索 “Lombok”，版本建议 233.14475.28+）
- 修改
module-info.java后务必重启 IDE 或重载 Maven 项目，否则缓存可能导致配置不生效
