lombok 注解在从外部 jar 引入的类中不生效，根本原因在于 lombok 的代码生成发生在编译期，而共享 jar 通常只包含已编译的字节码——若原始 jar 构建时未正确启用 lombok 注解处理器，则生成逻辑不会执行，导致 getter/setter、构造器等缺失。
问题本质：Lombok 不是“运行时魔法”，而是编译期代码生成器
Lombok 并非通过反射或字节码增强在运行时注入方法，而是依赖 Java 编译器的 Annotation Processing Tool（APT） 在编译 .java 源文件时，动态生成对应的方法、构造器、Builder 类等，并写入 .class 文件。因此：
- ✅ 若你将 @Data 类的源码（.java） 直接放在 Spring Boot 项目中，且项目已配置 Lombok 注解处理器，则一切正常；
- ❌ 若你仅提供一个预编译好的 xxx-entities-1.0.jar，而该 JAR 是在未启用 Lombok APT 的环境下构建的，那么其中的 .class 文件里就根本不存在由 Lombok 生成的任何方法——此时无论下游项目如何配置 Lombok，都无济于事。
? 验证方法：解压 JAR，用 javap -p com.example.UserDto.class 查看字节码。若看不到 getUsername()、setUsername(...) 或全参构造器等，说明 Lombok 生成阶段已被跳过。
正确构建含 Lombok 的共享库（Gradle）
关键点：Lombok 必须参与共享库自身的编译过程，而非仅在使用方配置。
以下为推荐的 build.gradle（Gradle 7.2+）配置，适用于存放实体与 DTO 的模块（如 entities 子项目）：
ext {
lombokVersion = '1.18.34' // 建议使用最新稳定版（截至 2024）
}
plugins {
id 'java'
id 'maven-publish' // 如需发布到私有仓库，建议启用
}
java {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
dependencies {
// Lombok 仅在编译期需要，不参与运行时依赖传递
compileOnly "org.projectlombok:lombok:${lombokVersion}"
annotationProcessor "org.projectlombok:lombok:${lombokVersion}"
// 测试相关（可选但推荐）
testCompileOnly "org.projectlombok:lombok:${lombokVersion}"
testAnnotationProcessor "org.projectlombok:lombok:${lombokVersion}"
// 其他依赖（如 Hibernate、Jackson 等）
implementation 'jakarta.persistence:jakarta.persistence-api:3.1.0'
}⚠️ 重要说明：
- compileOnly + annotationProcessor 是黄金组合：前者避免 Lombok 被意外打包进最终 JAR，后者确保注解处理器在编译源码时被激活；
- 不要使用 implementation 引入 Lombok —— 这会导致 Lombok 类被错误打包，且无法触发注解处理；
- 若使用 Gradle 插件方式（如 id 'io.freefair.lombok'），请确保其版本兼容，并显式启用 lombok.config 支持（如有自定义配置）。
使用方（Spring Boot 项目）无需额外配置 Lombok（但需注意 IDE）
你的 Spring Boot 项目中当前使用：
implementation files('lib/xxx-entities-1.0.jar')✅ 这本身没有问题——只要 xxx-entities-1.0.jar 中的 class 文件已包含 Lombok 生成的全部成员，下游项目即可直接调用 user.getName()、User.builder().name("...").build() 等。
⚠️ 但 IntelliJ IDEA 用户常遇“红色报错”（如 Cannot resolve method 'getName()'），这是因为：
- IDEA 默认不读取 JAR 中的 Lombok 生成逻辑（它只解析源码或已生成的字节码结构）；
- 即使字节码正确，IDE 也无法自动推导出这些“隐式”方法。
解决方案（IDEA）：
- 安装并启用 Lombok Plugin（Settings → Plugins → 搜索 “Lombok” → Install & Restart）；
- 启用 Enable annotation processing（Settings → Build → Compiler → Annotation Processors → ✅ Enable annotation processing）；
- （可选）在项目根目录放置 lombok.config，添加 lombok.anyConstructor.addConstructorProperties = true 等统一配置。
? 提示：Maven 用户可改用
provided + 私有仓库（如 Nexus）替代 files(...)，更利于依赖管理和版本控制。
总结：三步确保 Lombok 在共享库中可靠工作
| 步骤 | 操作 | 是否必需 |
|---|---|---|
| ✅ 1. 构建端启用 APT | 在共享库的 build.gradle 中声明 annotationProcessor "org.projectlombok:lombok:..." | ✔️ 必须 |
| ✅ 2. 验证产物有效性 | 解压 JAR，用 javap 检查关键类是否含生成方法 | ✔️ 推荐（上线前必做） |
| ✅ 3. IDE 正确识别 | IDEA 安装插件 + 开启 annotation processing | ✔️ 开发体验必需 |
记住：Lombok 的能力止步于它参与编译的那个环节。 把它当成一个“智能模板引擎”，而不是“运行时魔术师”。只要你在共享库构建阶段把它请到位，生成的 JAR 就是开箱即用的“成品”，下游项目只需当作普通 Java 类使用即可。
