lombok 注解在从外部 jar 引入的类中不生效，根本原因在于 lombok 的代码生成发生在编译期，而 jar 中若仅包含原始源码或未经 lombok 处理的字节码，则运行时无法自动补全 getter/setter 等方法。
问题本质：Lombok 不是“运行时增强”，而是“编译期代码生成”
Lombok 并非通过字节码插桩（如 AspectJ）或反射在运行时动态添加方法，而是依赖 Java 编译器的 Annotation Processing Tool（APT） 在 javac 编译阶段直接修改抽象语法树（AST），将 @Data 等注解“展开”为实际的 getter、setter、构造器等 Java 代码，并最终编译进 .class 文件。因此：
- ✅ 若你的共享模块（如 xxx-entities）在构建 JAR 时已正确触发 Lombok APT，则生成的 .class 文件中已包含完整的方法实现，下游项目无需再处理 Lombok 注解；
- ❌ 若 JAR 中的 .class 文件缺失这些方法（可用 JD-GUI 或 javap -p YourDto.class 验证），说明 Lombok 在打包阶段根本未生效——此时下游 Spring Boot 项目即使配置了 Lombok，也无济于事。
正确构建含 Lombok 的共享库（Gradle）
关键点：Lombok 必须参与共享库自身的编译过程，而非下游项目的编译。以下为推荐的 build.gradle 配置（Gradle 7.0+）：
plugins {
id 'java'
}
ext {
lombokVersion = '1.18.30' // 建议使用最新稳定版
}
dependencies {
// Lombok 仅需在编译期存在，不打入最终 JAR（避免传递依赖污染）
compileOnly "org.projectlombok:lombok:${lombokVersion}"
annotationProcessor "org.projectlombok:lombok:${lombokVersion}"
// 测试相关（可选）
testCompileOnly "org.projectlombok:lombok:${lombokVersion}"
testAnnotationProcessor "org.projectlombok:lombok:${lombokVersion}"
}⚠️ 注意事项：禁用 implementation 或 api 引入 Lombok：compileOnly + annotationProcessor 是唯一正确组合；implementation "lombok" 会导致 Lombok 类被错误打包进 JAR，引发 ClassLoader 冲突。勿在下游项目重复启用 Lombok 处理共享类：Spring Boot 项目只需确保自身源码能用 Lombok 即可（例如添加 lombok 依赖），但绝不应期望它为 xxx-entities-1.0.jar 中的类重新生成方法。验证 JAR 内容：构建后解压 JAR，用 javap -p com.example.UserDto.class 检查是否包含 getName(), setName(...), builder() 等方法。若无，则问题一定出在共享库的构建环节。
IntelliJ IDEA 的额外配置（避免 IDE 误报）
即使 Gradle 构建正确，IntelliJ 也可能因未识别 Lombok 处理而显示红色错误（如 “cannot resolve method getXXX”）。请确认：
- 安装并启用 Lombok Plugin（Settings → Plugins → 搜索 Lombok → Enable）；
- 开启 Enable annotation processing（Settings → Build → Compiler → Annotation Processors → ✔ Enable annotation processing）；
- （可选）在共享模块的 build.gradle 中添加 idea { module { inheritClasspath = false } }，避免 IDEA 错误继承父项目 classpath。
总结：三步定位与修复
| 步骤 | 操作 | 验证方式 |
|---|---|---|
| ① 查 | 解压 JAR，检查 .class 文件是否含 Lombok 生成的方法 | javap -p path/to/YourDto.class \| grep getName |
| ② 改 | 在共享库 build.gradle 中严格使用 compileOnly + annotationProcessor | 确保 gradle build 输出日志含 Lombok AST transformation |
| ③ 验 | 下游项目改用 implementation project(':xxx-entities')（推荐）或 implementation files(...) 后 clean rebuild | IDE 无报错，且运行时可正常调用 dto.getName() |
遵循此流程，Lombok 注解将在共享 JAR 中“永久固化”，下游项目开箱即用，彻底告别“注解失效”困扰。
