Lombok 注解失效是 Java 開發中的常見問題，通常由依賴配置、IDE 支持或構建工具設置引起。最近在拉取別人springboot3+jdk21版本的項目時遇到了lombok注解失效，導致項目無法啟動的問題，以下是我的解決方案：

首先檢查idea 的lombok的注解設置：

務必和默認設置一樣！！！

以下是網上的一些解決方案，希望對大家有所幫助：

🔧 ??一、檢查依賴配置?

1. ??Maven 項目??
   在 pom.xml 中確保依賴包含 annotationProcessor 配置：

   <dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version> <!-- 使用最新版本 --><scope>provided</scope>
   </dependency>
   <build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.11.0</version><configuration><annotationProcessorPaths><path><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version></path></annotationProcessorPaths></configuration></plugin></plugins>
   </build>

2. ??Gradle 項目??
   在 build.gradle 中添加：

   dependencies {compileOnly 'org.projectlombok:lombok:1.18.30'annotationProcessor 'org.projectlombok:lombok:1.18.30'
   }

?? ??關鍵點??：

• 移除 <optional>true</optional>（會導致依賴傳遞失效）
• 顯式聲明 maven-compiler-plugin 版本（避免默認版本不兼容）

---

🔌 ??二、配置 IDE 支持（必做）??

??IntelliJ IDEA??

1. ??安裝插件??：
   File → Settings → Plugins → 搜索 Lombok → 安裝并重啟 IDE。
2. ??啟用注解處理??：
   File → Settings → Build, Execution, Deployment → Compiler → Annotation Processors → 勾選 ??? Enable annotation processing?? 和 ??? Obtain processors from project classpath??。

??Eclipse??

1. 下載 lombok.jar → 運行 java -jar lombok.jar → 選擇 Eclipse 安裝路徑安裝 → 重啟 IDE。

---

🧹 ??三、清理緩存與重建項目??

1. ??清理 IDE 緩存??：
   • IntelliJ：File → Invalidate Caches → Invalidate and Restart
   • Eclipse：Project → Clean
2. ??命令行清理??：

   # Maven
   mvn clean install -U
   # Gradle
   ./gradlew clean build --refresh-dependencies

---

?? ??四、排查版本兼容性??

環境	要求
??JDK??	Lombok 1.18.22+ 支持 JDK 17+；Lombok 1.18.10+ 支持 JDK 11
??IDE??	IntelliJ 2020.3+ 或 Eclipse 2023-03+（舊版本需升級）
??構建工具??	Maven 3.6.3+/Gradle 7.x+（避免舊版注解處理兼容性問題）

📌 通過命令檢查版本：

java -version  # 確認 JDK
mvn -v         # 確認 Maven

---

🔍 ??五、驗證 Lombok 是否生效??

1. 創建測試類：

   @Data
   public class User {private String name;private Integer age;
   }

2. 嘗試調用 user.setName("test")：
   • 若 IDE 不報錯且編譯后生成 User.class 字節碼（包含 setName()/getName()），則 Lombok 生效。

---

? ??六、特殊場景處理??

1. ??Spring Boot 多模塊項目??：
   確保 Lombok 依賴在 ??所有子模塊?? 的 pom.xml 中聲明（或父模塊依賴傳遞）。
2. ??Lombok 與其他注解處理器沖突??：
   在 maven-compiler-plugin 中按需添加其他處理器路徑（如 MapStruct）：

   <annotationProcessorPaths><path>org.projectlombok:lombok</path><path>org.mapstruct:mapstruct-processor</path>
   </annotationProcessorPaths>

---

💎 總結流程

graph TDA[Lombok失效] --> B[檢查依賴配置]A --> C[安裝并啟用IDE插件]A --> D[清理緩存并重建項目]A --> E[驗證版本兼容性]E --> F{是否解決？}F -- 否 --> G[檢查多模塊/沖突]F -- 是 --> H[成功]

若仍不生效，檢查項目目錄結構是否符合 Maven/Gradle 標準（非標準結構會導致注解處理器失效），或在 Lombok GitHub Issues 搜索具體錯誤。