1. 問題現(xiàn)象與根因定位1.1 典型癥狀我先說說最典型的畫面從 Spring Initializr 新建一個 Spring Boot 項(xiàng)目開發(fā)工具里勾選或者手動在 pom.xml 里寫入了 Lombok 依賴然后信心滿滿地給實(shí)體類加上Data緊接著去寫user.getName()這種 getter 調(diào)用結(jié)果 IDE 直接在方法名上畫紅線說找不到方法。點(diǎn)編譯控制臺報一堆java: cannot find symbol符號位置就在那些本該由 Lombok 生成的 getter/setter 上。但更詭異的是Slf4j注入的log對象卻能正常使用Data的toString()好像也能用其實(shí)這種情況往往是 IDE 層面的 Lombok 支持沒生效或者編譯時注解處理器沒跑起來。還有一小部分情況是依賴沖突或者 JDK 版本太新導(dǎo)致 Lombok 處理器被編譯器直接忽略。1.2 為什么會自動創(chuàng)建卻無效很多人的第一反應(yīng)是我是不是漏了依賴然后反復(fù)檢查 pom.xml甚至把依賴刪了重新加。但這里的關(guān)鍵在于IDEA 里新建 Spring Boot 項(xiàng)目時即使你在依賴列表里勾選了 Lombok那也只是往 pom.xml 里寫了依賴坐標(biāo)。Lombok 不是一個普通的庫它屬于“注解處理器”需要在編譯階段介入把注解變成真實(shí)的 Java 代碼。這個過程有兩個岔路如果使用 Maven 命令行編譯那么依賴?yán)锉仨毎⒔馓幚砥鞫?Lombok 在 Maven 編譯時默認(rèn)就能通過provided作用域生效這個沒問題。如果使用 IDEA 的編譯功能也就是直接點(diǎn)綠色錘子那么 IDEA 自身的編譯器需要能識別 Lombok 注解。這就依賴兩個東西一是 IDEA 里安裝了 Lombok 插件新版 IDEA 內(nèi)置了但可能沒啟用二是 IDEA 的 Annotation Processing注解處理開關(guān)要打開。這兩個條件缺一個就會出現(xiàn)依賴在 pom 里躺得好好的但代碼就是編譯不過的局面。你可以理解成Lombok 是一個需要“翻譯官”的庫Maven 自己帶了翻譯官但 IDEA 的編譯流程必須要額外配置才能請到這位翻譯官。1.3 必須先明白的檢查順序網(wǎng)上很多教程一上來就讓重裝插件但其實(shí)步驟是有先后邏輯的。我推薦的排查順序是先看插件是否存在且啟用再看 annotation processing 開關(guān)然后才去折騰依賴和 JDK 兼容性。因?yàn)椴寮烷_關(guān)是 IDEA 層面的依賴是項(xiàng)目層面的按這個順序能快速定位問題不會盲目浪費(fèi)時間。2. 從零到一的完整解決路徑2.1 檢查并啟用 IDEA 的 Lombok 插件首先打開 IDEA 設(shè)置界面File - SettingsWindows或IntelliJ IDEA - PreferencesmacOS然后進(jìn)入Plugins搜索框輸入 “Lombok”。如果你用的是 2020.1 及以后的 IDEA 版本Lombok 插件其實(shí)是和 IDE 捆綁在一起的但默認(rèn)可能沒有勾選啟用。你要在已安裝插件列表里找到Lombok確認(rèn)它的勾選框是否打勾。如果沒有勾選上然后重啟 IDEA。如果你用的是社區(qū)版Community Edition同樣可以裝這個插件。但要注意社區(qū)版對 Spring Boot 項(xiàng)目支持本來就受限制不過 Lombok 插件本身是完全可用的。如果你聯(lián)網(wǎng)困難可以參照后面的離線安裝方法。提示部分新版本 IDEA 已經(jīng)將 Lombok 插件標(biāo)記為“Bundled捆綁”不需要手動從插件市場安裝。但不要把“已安裝”誤認(rèn)為“已啟用”這是兩回事。2.2 啟用 Annotation Processing注解處理這是最容易忽略的一步。IDEA 默認(rèn)不會主動運(yùn)行 Lombok 這類注解處理器除非你手動開啟。路徑是File - Settings - Build, Execution, Deployment - Compiler - Annotation Processors這里有很關(guān)鍵的一個復(fù)選框Enable annotation processing。默認(rèn)是不勾選的。勾選后你可以順手把下面的Obtain processors from project classpath也勾上。這個選項(xiàng)表示從項(xiàng)目的依賴路徑中自動獲取注解處理器換句話說就是讓 IDEA 去 classpath 里找 Lombok 的處理器類。如果你不勾有的項(xiàng)目配置下 IDEA 可能不會自動識別雖然大部分情況不影響但勾上更穩(wěn)妥。另外這里的配置分兩種級別Project 級別和 Module 級別。如果你只對某個模塊開啟就在右側(cè)的模塊列表里單獨(dú)操作。我建議先直接在最頂層的 Project 設(shè)置里開啟省得到時候每個模塊都要配一遍。完成設(shè)置后點(diǎn)擊Apply和OK然后最好重啟一下 IDEA。2.3 確認(rèn) pom.xml 依賴正確很多時候問題出在依賴聲明不完整。Lombok 的正確依賴寫法如下dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency注意optional標(biāo)簽標(biāo)記為 true 意味著這個依賴不會傳遞到下游模塊這是標(biāo)準(zhǔn)寫法。如果你用的是 Spring Boot 的spring-boot-starter-parent作為父工程那么 Lombok 的版本號由父工程統(tǒng)一管理不需要手動指定上面的寫法就夠了。但如果你沒有使用 Spring Boot 的父依賴或者版本管理混亂建議手動指定版本號例如dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.30/version scopeprovided/scope /dependency這里使用provided作用域表示編譯時和測試時需要但打成的 jar 包中不包含 Lombok 的類因?yàn)檫\(yùn)行期不需要它的代碼。如果誤用compile作用域雖然多數(shù)時候也能工作但可能造成包體變大或者在部署時有一些意想不到的類沖突。還有一種情況是 Lombok 版本太老。很多舊教程還在用1.16.x甚至1.14.x那些版本對新的 JDK比如 Java 17、Java 21支持得很差甚至完全無法工作。你需要在 pom.xml 中點(diǎn)中l(wèi)ombok依賴名看右側(cè) Maven 窗口顯示的依賴版本或者直接在本地倉庫里檢查。老版本請直接升級到 1.18.20 以上。2.4 解決 JDK 與 Lombok 的兼容性問題很多人在完成前面兩步后依然看到這樣一條編譯報錯java: You arent using a compiler supported by lombok, so lombok will not work.這句話的字面意思就是當(dāng)前使用的編譯器或者 JDK 版本不在 Lombok 支持列表里。Lombok 是通過修改編譯器內(nèi)部行為來實(shí)現(xiàn)在編譯時生成方法的它極度依賴編譯器版本。如果你用的 JDK 是剛發(fā)布的新版本而 Lombok 還沒來得及適配就會觸發(fā)這個異常。解決辦法有幾種升級 Lombok 到最新版本。Lombok 官方對 JDK 的支持更新還算勤快比如 JDK 21 出來后需要 Lombok 1.18.30 及以上版本。如果項(xiàng)目對 Lombok 版本有強(qiáng)約束例如公司統(tǒng)一規(guī)定那就把開發(fā)環(huán)境的 JDK 切換到項(xiàng)目期望的版本比如 11 或 17。IDEA 里可以通過Project Structure - Project SDK和Project Structure - Modules - Language level調(diào)整。確認(rèn) IDEA 使用的編譯器是javac而不是 Eclipse。IDEA 默認(rèn)編譯方式是javac但如果你改成了 Eclipse 編譯器Lombok 的兼容性可能會有別的幺蛾子建議在Settings - Build, Execution, Deployment - Compiler - Java Compiler里選擇Javac。2.5 最后一步清理緩存并重啟這個動作看起來像玄學(xué)但確實(shí)管用。IDEA 的緩存可能會導(dǎo)致插件、注解處理器狀態(tài)沒有被正確加載。操作路徑是File - Invalidate Caches...在彈出的窗口中選擇Invalidate and Restart。這會清理 IDEA 的本地索引和緩存同時自動重啟。重啟后IDEA 會重新索引項(xiàng)目加載插件此時再嘗試編譯大多數(shù)問題都會消失。如果清理后還不行那大概率是更底層的配置問題比如 Maven 的settings.xml里鏡像或倉庫配置有問題導(dǎo)致 Lombok 依賴實(shí)際上沒有下載完整。這種時候建議檢查一下本地 Maven 倉庫~/.m2/repository/org/projectlombok/lombok路徑下的 jar 文件是否存在并且大小正常。如果 jar 有問題手動把整個lombok文件夾刪掉然后重新刷新 Maven 依賴。3. 實(shí)操演示完整走一遍可復(fù)現(xiàn)的示例3.1 新建項(xiàng)目與基礎(chǔ)配置我用一個最簡單的場景帶大家走通全流程。假設(shè)你已經(jīng)準(zhǔn)備好 IDEA并且打算新建一個 Spring Boot 項(xiàng)目。打開 IDEA選擇New Project左側(cè)選Spring Initializr。填寫項(xiàng)目名稱、坐標(biāo)、包名。在Dependencies面板里搜索并勾選Spring Web和Lombok。點(diǎn)擊完成項(xiàng)目創(chuàng)建后先等右下角的 Maven 導(dǎo)入完成。然后打開pom.xml確認(rèn) Lombok 依賴已經(jīng)存在。按照前面說的步驟先檢查插件和 Annotation Processing 設(shè)置這里假設(shè)都已經(jīng)配置好。3.2 編寫實(shí)體類和使用 Lombok創(chuàng)建一個User類放在com.example.demo.entity包下package com.example.demo.entity; import lombok.Data; Data public class User { private Long id; private String name; private Integer age; }然后寫一個簡單的測試接口在 Controller 里直接使用 Lombok 生成的方法package com.example.demo.controller; import com.example.demo.entity.User; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; RestController RequestMapping(/user) public class UserController { GetMapping(/test) public String testLombok() { User user new User(); user.setId(1L); user.setName(張三); user.setAge(18); return user.toString(); } }如果你用了Data那User類中不應(yīng)該手動寫 getter/setter也不要手動寫toString。只要 IDEA 編譯通過運(yùn)行后訪問http://localhost:8080/user/test就能看到類似User(id1, name張三, age18)的輸出這就說明 Lombok 生效了。3.3 通過編譯后的 class 文件二次確認(rèn)有一種最直觀的方式確認(rèn) Lombok 是否真的工作找到編譯輸出的target/classes目錄找到User.class文件在 IDEA 的Project視圖里展開點(diǎn)擊這個 class 文件IDEA 會自動反編譯。你會看到源碼中并沒有寫出來的getId、setId、toString等方法并且它們都帶有一個Generated by Lombok標(biāo)記?？吹竭@個標(biāo)記說明 Lombok 處理器確實(shí)執(zhí)行了。如果你看不到可能是 IDEA 的反編譯插件沒裝。這種情況下可以打開View - Tool Windows - Maven在Lifecycle里雙擊compile讓 Maven 來編譯一次然后手動用外部工具比如javap查看 class 文件javap -p target/classes/com/example/demo/entity/User.class如果輸出中出現(xiàn)了public java.lang.String getName()等結(jié)果同樣說明 Lombok 在 Maven 環(huán)境下有效。但如果 IDEA 自己的運(yùn)行配置還是報找不到符號那就是 IDEA 編譯環(huán)境仍然有問題回頭檢查第 2 節(jié)里面的設(shè)置。3.4 驗(yàn)證過程中的常見干擾我實(shí)操過幾次發(fā)現(xiàn)在運(yùn)行 Spring Boot 項(xiàng)目時如果只是代碼在編輯器里顯示紅色下劃線但項(xiàng)目編譯運(yùn)行都正常這是純提示層面的問題往往是 IDEA 的編輯緩存和編譯結(jié)果不一致?？梢韵葓?zhí)行一次Build - Rebuild Project如果構(gòu)建成功紅色波浪線可能還是會殘留一會這時不要急著改配置先等 IDEA 的索引刷新或者重啟一下窗口。還有就是多模塊項(xiàng)目的干擾。假設(shè)你的父工程和子模塊都用到了 Lombok但只在父工程里聲明了依賴子模塊沒有顯式聲明。這種情況在 Spring Boot 多模塊架構(gòu)里很常見子模塊也能編譯通過但有時 IDEA 的注解處理器會找不到對應(yīng)的類路徑導(dǎo)致某些模塊報錯。建議在每個需要用到 Lombok 的子模塊中顯式引入依賴。4. 常見問題與排查技巧實(shí)錄4.1 編譯報 “java: You arent using a compiler supported by lombok”這個報錯我已經(jīng)提過但值得再展開細(xì)說。它的觸發(fā)條件不一定是 JDK 版本太新如果你的項(xiàng)目配置了特殊的--release參數(shù)或者用了老版本的 Lombok也會觸發(fā)。具體的排查方法先看 JDK 版本java -version。再看 Lombok 版本在 pom.xml 里定位或者使用 Maven 的 dependency 插件查看。mvn clean compile -X這條命令會把編譯過程完整打印出來搜索片段path-to-lombok可以看到 IDEA 實(shí)際使用的是哪個 Lombok jar。如果這里顯示的lombok-1.16.x.jar那就不用糾結(jié)了直接升版本。如果確實(shí)要保留低版本 Lombok可以將項(xiàng)目的 Language Level 調(diào)到 8 或 11JAVA 版本也降到匹配的范圍因?yàn)槔习姹?Lombok 對高版本的 class 文件格式是不兼容的。但天天腰疼還不如升級。4.2 更新 IDEA 后 Lombok 突然失效這種事件很常見。IDEA 升級后舊版本的 Lombok 插件可能因?yàn)榧嫒菪詥栴}被自動禁用了。你可以在Settings - Plugins - Installed里看到Lombok項(xiàng)它的啟用勾選框可能變成了未勾選狀態(tài)重新勾選并重啟即可。另外新版 IDEA 里 Lombok 插件已經(jīng)和 Spring 插件整合有些版本修改了插件的配置方式。如果你看到的是Lombok Plugin被標(biāo)記為Bundled那不需要額外安裝但你要檢查Enable annotation processing是否在升級過程中被重置了。因?yàn)槲矣龅竭^好幾次IDEA 升級后默認(rèn)配置被恢復(fù)Annotations Processors 的勾選被撤掉了。4.3 依賴標(biāo)紅或 Maven 導(dǎo)入失敗的解法如果 pom.xml 中 Lombok 依賴下方出現(xiàn)紅色波浪線說明依賴還沒有成功進(jìn)入 IDEA 的 classpath。先在右側(cè) Maven 工具欄點(diǎn)擊刷新按鈕一個循環(huán)圖標(biāo)。如果刷新后還是紅色打開Settings - Build, Execution, Deployment - Build Tools - Maven檢查Local repository路徑確認(rèn)是不是路徑寫錯了。也可以嘗試手動執(zhí)行一段命令強(qiáng)制更新mvn -U idea:idea這會在命令行生成 IDEA 的項(xiàng)目文件雖然現(xiàn)代 IDEA 已經(jīng)很少需要但在特殊情況下能重新生成.iml文件和依賴信息。還有一個冷門但真實(shí)的問題Lombok jar 包損壞或下載不完整。解決辦法是刪除本地倉庫里org/projectlombok整個目錄然后重新mvn clean install或者讓 IDEA 重新導(dǎo)入。這個操作會強(qiáng)制觸發(fā)下載耗時不長。4.4 為什么 Maven 命令行正常IDEA 運(yùn)行卻報錯這個問題通常有兩個原因。第一個原因是 IDEA 內(nèi)置編譯器和 Maven 使用的 JDK 版本不一致。Maven 配置的是JAVA_HOME環(huán)境變量指向的 JDK而 IDEA 的項(xiàng)目 SDK 可能是另一個版本。比如 Maven 用 Java 8 編譯完全沒問題IDEA 卻用的是 Java 21Lombok 老版本就扛不住了。這種情況在本地同時裝了好幾個 JDK 時特別容易發(fā)生。檢查方法Settings - Build, Execution, Deployment - Build Tools - Maven - Runner這里的JRE選項(xiàng)會影響 Maven 運(yùn)行時用的 JDKProject Structure - Project SDK決定 IDEA 編譯器用的 JDK。把這兩處統(tǒng)一到同一個版本問題就能解決。第二個原因是 IDEA 之前緩存了舊的編譯錯誤。明明配置已經(jīng)修正但點(diǎn)運(yùn)行還是報同樣的錯。這時不要糾結(jié)直接Build - Rebuild Project如果還是不行就Invalidate Caches。4.5 完全沒有網(wǎng)絡(luò)時怎么裝 Lombok 插件有些公司開發(fā)環(huán)境是不允許外網(wǎng)的IDEA 默認(rèn)的插件市場連不上。這時你可以用離線安裝。先在能上網(wǎng)的機(jī)器上從 JetBrains 插件市場頁面下載 Lomobok 插件的 zip 包。注意要選和你 IDEA 版本匹配的版本IDEA 插件市場會按你的 IDEA 版本過濾。下載后拷貝到離線機(jī)器在 IDEA 里打開Settings - Plugins點(diǎn)擊右上角的齒輪按鈕選擇Install Plugin from Disk...選中 zip 包后安裝重啟即可。如果你用的 IDEA 是 2020.1 及以上版本那么 Lombok 插件本身就在 IDEA 安裝目錄的plugins子目錄里。去安裝目錄下找找有沒有l(wèi)ombok或lombok-plugin文件夾。如果有說明插件存在只是沒有被啟用直接在插件列表里啟用就行不需要下載。5. 一些容易踩的深層坑5.1 注解處理器配置錯誤導(dǎo)致其他注解也失效有人為了讓 Lombok 生效手動修改了注解處理器設(shè)置結(jié)果導(dǎo)致 Spring Boot 的ConfigurationProperties或者ComponentScan處理器也出了問題。因?yàn)锳nnotation Processors配置里可以自定義處理器路徑如果你誤加了其他不相關(guān)的處理器編譯器會發(fā)生沖突。我個人推薦的做法勾選Enable annotation processing和Obtain processors from project classpath就夠了不要手動在處理器列表里添加任何全限定類名。Lombok 的處理器類一般是lombok.launch.AnnotationProcessorHider$AnnotationProcessor它會在 classpath 中自動被發(fā)現(xiàn)。除非你有非常特殊的自定義處理器否則保持默認(rèn)就是最穩(wěn)的。5.2 多個 Lombok 版本同時存在如果你的本地 Maven 倉庫中既有 1.18.22 又有 1.18.30且項(xiàng)目依賴沖突導(dǎo)致 IDEA 選擇了錯誤版本也會出現(xiàn)奇怪現(xiàn)象。比如明明項(xiàng)目 pom 里寫了 1.18.30但 IDEA 的編譯日志里顯示使用的是另一個版本。這種情況需要檢查依賴樹mvn dependency:tree -Dincludesorg.projectlombok:lombok看到輸出后確認(rèn)項(xiàng)目最終解析出來的版本是什么。如果發(fā)現(xiàn)是舊的傳遞依賴可以在 pom.xml 中對直接聲明的依賴強(qiáng)制指定版本。有時候 Spring Boot 父依賴管理的 Lombok 版本可能比最新版低但默認(rèn)是相對穩(wěn)定的。如果確實(shí)遇上 JDK 新版本兼容問題可以在properties中顯式覆蓋properties lombok.version1.18.30/lombok.version /properties5.3 在 Java 模塊化項(xiàng)目里使用 Lombok如果你在用 Java 9 以上的模塊化項(xiàng)目module-info.java里需要聲明requires lombok;嗎不需要也不應(yīng)該。Lombok 只在編譯期工作它不進(jìn)入運(yùn)行模塊圖。如果在模塊描述文件里增加 Lombok 依賴反而可能導(dǎo)致模塊解析異常。正確的做法是在模塊描述文件中忽略 Lombok保持它在requires之外并且依賴作用域設(shè)置為provided。在 Spring Boot 的實(shí)際場景中絕大多數(shù)項(xiàng)目沒有使用模塊化所以這個問題并不常見但如果你在搞一些比較新的工程結(jié)構(gòu)可以留個印象。5.4 編譯時 Lombok 生效但運(yùn)行時報 NoSuchMethodError還有一種少見但讓人頭疼的情況代碼編譯通過了運(yùn)行期啟動 Spring Boot 時某個類報NoSuchMethodError提示找不到getXXX方法。這種多半是目標(biāo) class 文件沒有真正包含編譯期生成的方法但 IDEA 編譯時又沒有報錯。我遇到過一次是因?yàn)槟K編譯順序問題一個模塊里的target/classes沒有及時更新導(dǎo)致運(yùn)行時加載的 class 是舊版本。解決辦法是把項(xiàng)目徹底mvn clean一次然后重新 compile。在 IDEA 里可以執(zhí)行Build - Rebuild Project清理所有模塊的編譯輸出避免臟 class 遺留。6. 繞不開的 IDE 版本差異6.1 社區(qū)版 vs 商業(yè)版對 Lombok 的支持差異很多初學(xué)者用的 IDEA Community 版擔(dān)心是不是因?yàn)樯鐓^(qū)版導(dǎo)致 Lombok 失效。其實(shí)不是。Lombok 插件對社區(qū)版和商業(yè)版的底層支持是一樣的。但社區(qū)版不支持 Spring Initializr 項(xiàng)目向?qū)Ю锏哪承┕δ鼙热缧陆?xiàng)目時自動加入 Spring Boot 相關(guān)依賴這會導(dǎo)致你無法在向?qū)е兄苯庸催x Lombok。如果你用了社區(qū)版那么可以在創(chuàng)建完普通項(xiàng)目后手動在 pom.xml 中添加依賴。其他步驟不變。所以不要再懷疑是社區(qū)版的問題了Lombok 本身和 IDE 版本無關(guān)JVM 和編譯器才相關(guān)。6.2 IDEA 2023/2024 版本的新改動在最新幾個版本里JetBrains 把 Lombok 插件邏輯整合到了Dependencies的分析中。如果你打開Project Structure - Facets可能會看到 Spring 和 Lombok 的標(biāo)識。這些改動或許會帶來一些 UI 上的陌生感但核心設(shè)置路徑基本沒變。在 2024.1 及以后版本中Compiled classes output的路徑結(jié)構(gòu)有所調(diào)整但注解處理的開關(guān)位置仍然在原來的菜單里。如果你找不到可以直接在設(shè)置窗口左上角搜索框輸入 “Annotation”會快速定位。6.3 有些所謂的“IDEA 破解版”也會導(dǎo)致 Lombok 失效這里我必須強(qiáng)調(diào)一句不要使用非官方渠道的激活方式。且不談版權(quán)問題破解版的 IDEA 往往修改了核心 jar 包插件加載機(jī)制可能被破壞導(dǎo)致 Lombok 插件無法正確注冊為編譯器插件。很多人遇到“怎么設(shè)置都沒用”的疑難雜癥最后發(fā)現(xiàn)是因?yàn)橛昧瞬灰?guī)范的 IDEA 安裝包。我建議直接去 JetBrains 官網(wǎng)下載官方安裝包社區(qū)版就完全免費(fèi)。實(shí)在需要付費(fèi)功能的可以評估一下是否真的需要商業(yè)版或者使用開源替代品。在你的開發(fā)工具上穩(wěn)定性和可維護(hù)性永遠(yuǎn)是最優(yōu)先的。7. 最后再分享兩個小技巧第一個技巧是如果你在 IDEA 里怎么折騰都搞不定但 Maven 命令行編譯是正常的那就別再死磕 IDEA 編譯按鈕了?？梢栽赟ettings - Build, Execution, Deployment - Build Tools - Maven - Runner中勾選Delegate IDE build/run actions to Maven。這樣 IDEA 的構(gòu)建和運(yùn)行操作會直接轉(zhuǎn)交給 Maven 處理相當(dāng)于繞開了 IDEA 內(nèi)置編譯器。在這個模式下只要 Maven 能編譯過IDEA 里運(yùn)行 Spring Boot 項(xiàng)目也就沒問題。這個技巧尤其適合那些 IDEA 內(nèi)置編譯器就是和 Lombok 八字不合的極端環(huán)境。第二個技巧是使用 Lombok 時盡量讓實(shí)體類保持簡潔。Data雖然把 getter/setter/toString/equals/hashCode 全包了但在某些復(fù)雜業(yè)務(wù)場景下equals和hashCode的生成規(guī)則可能會拖垮性能。如果你只需要簡單的賦值和取值可以用Getter和Setter如果你不想生成 equals 和 hashCode可以單獨(dú)用Getter Setter ToString而不要無腦Data。這和本次的報錯主題無關(guān)但既然是聊 Lombok順手提醒一下開發(fā)者們養(yǎng)成習(xí)慣避免在長期維護(hù)的項(xiàng)目里給自己留坑。我這個環(huán)境里實(shí)際操作過太多次遇到的案例五花八門從最簡單的沒開注解處理到復(fù)雜的 JDK 版本不匹配再到因?yàn)?IDEA 插件國服鏡像問題導(dǎo)致插件安裝失敗。但只要按照插件優(yōu)先、注解處理其次、依賴版本兜底的思路走一遍百分之九十九的問題都能在當(dāng)前環(huán)境內(nèi)消化掉。剩下那百分之一直接使用Delegate IDE build/run actions to Maven這個終極大招就可以安心回代碼邏輯本身了。如果你現(xiàn)在正被這個問題卡著推進(jìn)度照著這篇把Settings一步一步走下來基本十分鐘內(nèi)就能看到編寫區(qū)里的紅色波浪線消失編譯也順利通過。要是還不行請把報錯日志再讀一遍看看是不是出現(xiàn)了ServiceConfigurationError或UnsupportedClassVersionError那些是另一個維度的問題但本文里提到的排查思路依然適用。 IDEA中Lombok失效的排查與解決：插件、注解處理與依賴配置全指南
1. 問題現(xiàn)象與根因定位1.1 典型癥狀我先說說最典型的畫面從 Spring Initializr 新建一個 Spring Boot 項(xiàng)目開發(fā)工具里勾選或者手動在 pom.xml 里寫入了 Lombok 依賴然后信心滿滿地給實(shí)體類加上Data緊接著去寫user.getName()這種 getter 調(diào)用結(jié)果 IDE 直接在方法名上畫紅線說找不到方法。點(diǎn)編譯控制臺報一堆java: cannot find symbol符號位置就在那些本該由 Lombok 生成的 getter/setter 上。但更詭異的是Slf4j注入的log對象卻能正常使用Data的toString()好像也能用其實(shí)這種情況往往是 IDE 層面的 Lombok 支持沒生效或者編譯時注解處理器沒跑起來。還有一小部分情況是依賴沖突或者 JDK 版本太新導(dǎo)致 Lombok 處理器被編譯器直接忽略。1.2 為什么會自動創(chuàng)建卻無效很多人的第一反應(yīng)是我是不是漏了依賴然后反復(fù)檢查 pom.xml甚至把依賴刪了重新加。但這里的關(guān)鍵在于IDEA 里新建 Spring Boot 項(xiàng)目時即使你在依賴列表里勾選了 Lombok那也只是往 pom.xml 里寫了依賴坐標(biāo)。Lombok 不是一個普通的庫它屬于“注解處理器”需要在編譯階段介入把注解變成真實(shí)的 Java 代碼。這個過程有兩個岔路如果使用 Maven 命令行編譯那么依賴?yán)锉仨毎⒔馓幚砥鞫?Lombok 在 Maven 編譯時默認(rèn)就能通過provided作用域生效這個沒問題。如果使用 IDEA 的編譯功能也就是直接點(diǎn)綠色錘子那么 IDEA 自身的編譯器需要能識別 Lombok 注解。這就依賴兩個東西一是 IDEA 里安裝了 Lombok 插件新版 IDEA 內(nèi)置了但可能沒啟用二是 IDEA 的 Annotation Processing注解處理開關(guān)要打開。這兩個條件缺一個就會出現(xiàn)依賴在 pom 里躺得好好的但代碼就是編譯不過的局面。你可以理解成Lombok 是一個需要“翻譯官”的庫Maven 自己帶了翻譯官但 IDEA 的編譯流程必須要額外配置才能請到這位翻譯官。1.3 必須先明白的檢查順序網(wǎng)上很多教程一上來就讓重裝插件但其實(shí)步驟是有先后邏輯的。我推薦的排查順序是先看插件是否存在且啟用再看 annotation processing 開關(guān)然后才去折騰依賴和 JDK 兼容性。因?yàn)椴寮烷_關(guān)是 IDEA 層面的依賴是項(xiàng)目層面的按這個順序能快速定位問題不會盲目浪費(fèi)時間。2. 從零到一的完整解決路徑2.1 檢查并啟用 IDEA 的 Lombok 插件首先打開 IDEA 設(shè)置界面File - SettingsWindows或IntelliJ IDEA - PreferencesmacOS然后進(jìn)入Plugins搜索框輸入 “Lombok”。如果你用的是 2020.1 及以后的 IDEA 版本Lombok 插件其實(shí)是和 IDE 捆綁在一起的但默認(rèn)可能沒有勾選啟用。你要在已安裝插件列表里找到Lombok確認(rèn)它的勾選框是否打勾。如果沒有勾選上然后重啟 IDEA。如果你用的是社區(qū)版Community Edition同樣可以裝這個插件。但要注意社區(qū)版對 Spring Boot 項(xiàng)目支持本來就受限制不過 Lombok 插件本身是完全可用的。如果你聯(lián)網(wǎng)困難可以參照后面的離線安裝方法。提示部分新版本 IDEA 已經(jīng)將 Lombok 插件標(biāo)記為“Bundled捆綁”不需要手動從插件市場安裝。但不要把“已安裝”誤認(rèn)為“已啟用”這是兩回事。2.2 啟用 Annotation Processing注解處理這是最容易忽略的一步。IDEA 默認(rèn)不會主動運(yùn)行 Lombok 這類注解處理器除非你手動開啟。路徑是File - Settings - Build, Execution, Deployment - Compiler - Annotation Processors這里有很關(guān)鍵的一個復(fù)選框Enable annotation processing。默認(rèn)是不勾選的。勾選后你可以順手把下面的Obtain processors from project classpath也勾上。這個選項(xiàng)表示從項(xiàng)目的依賴路徑中自動獲取注解處理器換句話說就是讓 IDEA 去 classpath 里找 Lombok 的處理器類。如果你不勾有的項(xiàng)目配置下 IDEA 可能不會自動識別雖然大部分情況不影響但勾上更穩(wěn)妥。另外這里的配置分兩種級別Project 級別和 Module 級別。如果你只對某個模塊開啟就在右側(cè)的模塊列表里單獨(dú)操作。我建議先直接在最頂層的 Project 設(shè)置里開啟省得到時候每個模塊都要配一遍。完成設(shè)置后點(diǎn)擊Apply和OK然后最好重啟一下 IDEA。2.3 確認(rèn) pom.xml 依賴正確很多時候問題出在依賴聲明不完整。Lombok 的正確依賴寫法如下dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency注意optional標(biāo)簽標(biāo)記為 true 意味著這個依賴不會傳遞到下游模塊這是標(biāo)準(zhǔn)寫法。如果你用的是 Spring Boot 的spring-boot-starter-parent作為父工程那么 Lombok 的版本號由父工程統(tǒng)一管理不需要手動指定上面的寫法就夠了。但如果你沒有使用 Spring Boot 的父依賴或者版本管理混亂建議手動指定版本號例如dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.30/version scopeprovided/scope /dependency這里使用provided作用域表示編譯時和測試時需要但打成的 jar 包中不包含 Lombok 的類因?yàn)檫\(yùn)行期不需要它的代碼。如果誤用compile作用域雖然多數(shù)時候也能工作但可能造成包體變大或者在部署時有一些意想不到的類沖突。還有一種情況是 Lombok 版本太老。很多舊教程還在用1.16.x甚至1.14.x那些版本對新的 JDK比如 Java 17、Java 21支持得很差甚至完全無法工作。你需要在 pom.xml 中點(diǎn)中l(wèi)ombok依賴名看右側(cè) Maven 窗口顯示的依賴版本或者直接在本地倉庫里檢查。老版本請直接升級到 1.18.20 以上。2.4 解決 JDK 與 Lombok 的兼容性問題很多人在完成前面兩步后依然看到這樣一條編譯報錯java: You arent using a compiler supported by lombok, so lombok will not work.這句話的字面意思就是當(dāng)前使用的編譯器或者 JDK 版本不在 Lombok 支持列表里。Lombok 是通過修改編譯器內(nèi)部行為來實(shí)現(xiàn)在編譯時生成方法的它極度依賴編譯器版本。如果你用的 JDK 是剛發(fā)布的新版本而 Lombok 還沒來得及適配就會觸發(fā)這個異常。解決辦法有幾種升級 Lombok 到最新版本。Lombok 官方對 JDK 的支持更新還算勤快比如 JDK 21 出來后需要 Lombok 1.18.30 及以上版本。如果項(xiàng)目對 Lombok 版本有強(qiáng)約束例如公司統(tǒng)一規(guī)定那就把開發(fā)環(huán)境的 JDK 切換到項(xiàng)目期望的版本比如 11 或 17。IDEA 里可以通過Project Structure - Project SDK和Project Structure - Modules - Language level調(diào)整。確認(rèn) IDEA 使用的編譯器是javac而不是 Eclipse。IDEA 默認(rèn)編譯方式是javac但如果你改成了 Eclipse 編譯器Lombok 的兼容性可能會有別的幺蛾子建議在Settings - Build, Execution, Deployment - Compiler - Java Compiler里選擇Javac。2.5 最后一步清理緩存并重啟這個動作看起來像玄學(xué)但確實(shí)管用。IDEA 的緩存可能會導(dǎo)致插件、注解處理器狀態(tài)沒有被正確加載。操作路徑是File - Invalidate Caches...在彈出的窗口中選擇Invalidate and Restart。這會清理 IDEA 的本地索引和緩存同時自動重啟。重啟后IDEA 會重新索引項(xiàng)目加載插件此時再嘗試編譯大多數(shù)問題都會消失。如果清理后還不行那大概率是更底層的配置問題比如 Maven 的settings.xml里鏡像或倉庫配置有問題導(dǎo)致 Lombok 依賴實(shí)際上沒有下載完整。這種時候建議檢查一下本地 Maven 倉庫~/.m2/repository/org/projectlombok/lombok路徑下的 jar 文件是否存在并且大小正常。如果 jar 有問題手動把整個lombok文件夾刪掉然后重新刷新 Maven 依賴。3. 實(shí)操演示完整走一遍可復(fù)現(xiàn)的示例3.1 新建項(xiàng)目與基礎(chǔ)配置我用一個最簡單的場景帶大家走通全流程。假設(shè)你已經(jīng)準(zhǔn)備好 IDEA并且打算新建一個 Spring Boot 項(xiàng)目。打開 IDEA選擇New Project左側(cè)選Spring Initializr。填寫項(xiàng)目名稱、坐標(biāo)、包名。在Dependencies面板里搜索并勾選Spring Web和Lombok。點(diǎn)擊完成項(xiàng)目創(chuàng)建后先等右下角的 Maven 導(dǎo)入完成。然后打開pom.xml確認(rèn) Lombok 依賴已經(jīng)存在。按照前面說的步驟先檢查插件和 Annotation Processing 設(shè)置這里假設(shè)都已經(jīng)配置好。3.2 編寫實(shí)體類和使用 Lombok創(chuàng)建一個User類放在com.example.demo.entity包下package com.example.demo.entity; import lombok.Data; Data public class User { private Long id; private String name; private Integer age; }然后寫一個簡單的測試接口在 Controller 里直接使用 Lombok 生成的方法package com.example.demo.controller; import com.example.demo.entity.User; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; RestController RequestMapping(/user) public class UserController { GetMapping(/test) public String testLombok() { User user new User(); user.setId(1L); user.setName(張三); user.setAge(18); return user.toString(); } }如果你用了Data那User類中不應(yīng)該手動寫 getter/setter也不要手動寫toString。只要 IDEA 編譯通過運(yùn)行后訪問http://localhost:8080/user/test就能看到類似User(id1, name張三, age18)的輸出這就說明 Lombok 生效了。3.3 通過編譯后的 class 文件二次確認(rèn)有一種最直觀的方式確認(rèn) Lombok 是否真的工作找到編譯輸出的target/classes目錄找到User.class文件在 IDEA 的Project視圖里展開點(diǎn)擊這個 class 文件IDEA 會自動反編譯。你會看到源碼中并沒有寫出來的getId、setId、toString等方法并且它們都帶有一個Generated by Lombok標(biāo)記?？吹竭@個標(biāo)記說明 Lombok 處理器確實(shí)執(zhí)行了。如果你看不到可能是 IDEA 的反編譯插件沒裝。這種情況下可以打開View - Tool Windows - Maven在Lifecycle里雙擊compile讓 Maven 來編譯一次然后手動用外部工具比如javap查看 class 文件javap -p target/classes/com/example/demo/entity/User.class如果輸出中出現(xiàn)了public java.lang.String getName()等結(jié)果同樣說明 Lombok 在 Maven 環(huán)境下有效。但如果 IDEA 自己的運(yùn)行配置還是報找不到符號那就是 IDEA 編譯環(huán)境仍然有問題回頭檢查第 2 節(jié)里面的設(shè)置。3.4 驗(yàn)證過程中的常見干擾我實(shí)操過幾次發(fā)現(xiàn)在運(yùn)行 Spring Boot 項(xiàng)目時如果只是代碼在編輯器里顯示紅色下劃線但項(xiàng)目編譯運(yùn)行都正常這是純提示層面的問題往往是 IDEA 的編輯緩存和編譯結(jié)果不一致?？梢韵葓?zhí)行一次Build - Rebuild Project如果構(gòu)建成功紅色波浪線可能還是會殘留一會這時不要急著改配置先等 IDEA 的索引刷新或者重啟一下窗口。還有就是多模塊項(xiàng)目的干擾。假設(shè)你的父工程和子模塊都用到了 Lombok但只在父工程里聲明了依賴子模塊沒有顯式聲明。這種情況在 Spring Boot 多模塊架構(gòu)里很常見子模塊也能編譯通過但有時 IDEA 的注解處理器會找不到對應(yīng)的類路徑導(dǎo)致某些模塊報錯。建議在每個需要用到 Lombok 的子模塊中顯式引入依賴。4. 常見問題與排查技巧實(shí)錄4.1 編譯報 “java: You arent using a compiler supported by lombok”這個報錯我已經(jīng)提過但值得再展開細(xì)說。它的觸發(fā)條件不一定是 JDK 版本太新如果你的項(xiàng)目配置了特殊的--release參數(shù)或者用了老版本的 Lombok也會觸發(fā)。具體的排查方法先看 JDK 版本java -version。再看 Lombok 版本在 pom.xml 里定位或者使用 Maven 的 dependency 插件查看。mvn clean compile -X這條命令會把編譯過程完整打印出來搜索片段path-to-lombok可以看到 IDEA 實(shí)際使用的是哪個 Lombok jar。如果這里顯示的lombok-1.16.x.jar那就不用糾結(jié)了直接升版本。如果確實(shí)要保留低版本 Lombok可以將項(xiàng)目的 Language Level 調(diào)到 8 或 11JAVA 版本也降到匹配的范圍因?yàn)槔习姹?Lombok 對高版本的 class 文件格式是不兼容的。但天天腰疼還不如升級。4.2 更新 IDEA 后 Lombok 突然失效這種事件很常見。IDEA 升級后舊版本的 Lombok 插件可能因?yàn)榧嫒菪詥栴}被自動禁用了。你可以在Settings - Plugins - Installed里看到Lombok項(xiàng)它的啟用勾選框可能變成了未勾選狀態(tài)重新勾選并重啟即可。另外新版 IDEA 里 Lombok 插件已經(jīng)和 Spring 插件整合有些版本修改了插件的配置方式。如果你看到的是Lombok Plugin被標(biāo)記為Bundled那不需要額外安裝但你要檢查Enable annotation processing是否在升級過程中被重置了。因?yàn)槲矣龅竭^好幾次IDEA 升級后默認(rèn)配置被恢復(fù)Annotations Processors 的勾選被撤掉了。4.3 依賴標(biāo)紅或 Maven 導(dǎo)入失敗的解法如果 pom.xml 中 Lombok 依賴下方出現(xiàn)紅色波浪線說明依賴還沒有成功進(jìn)入 IDEA 的 classpath。先在右側(cè) Maven 工具欄點(diǎn)擊刷新按鈕一個循環(huán)圖標(biāo)。如果刷新后還是紅色打開Settings - Build, Execution, Deployment - Build Tools - Maven檢查Local repository路徑確認(rèn)是不是路徑寫錯了。也可以嘗試手動執(zhí)行一段命令強(qiáng)制更新mvn -U idea:idea這會在命令行生成 IDEA 的項(xiàng)目文件雖然現(xiàn)代 IDEA 已經(jīng)很少需要但在特殊情況下能重新生成.iml文件和依賴信息。還有一個冷門但真實(shí)的問題Lombok jar 包損壞或下載不完整。解決辦法是刪除本地倉庫里org/projectlombok整個目錄然后重新mvn clean install或者讓 IDEA 重新導(dǎo)入。這個操作會強(qiáng)制觸發(fā)下載耗時不長。4.4 為什么 Maven 命令行正常IDEA 運(yùn)行卻報錯這個問題通常有兩個原因。第一個原因是 IDEA 內(nèi)置編譯器和 Maven 使用的 JDK 版本不一致。Maven 配置的是JAVA_HOME環(huán)境變量指向的 JDK而 IDEA 的項(xiàng)目 SDK 可能是另一個版本。比如 Maven 用 Java 8 編譯完全沒問題IDEA 卻用的是 Java 21Lombok 老版本就扛不住了。這種情況在本地同時裝了好幾個 JDK 時特別容易發(fā)生。檢查方法Settings - Build, Execution, Deployment - Build Tools - Maven - Runner這里的JRE選項(xiàng)會影響 Maven 運(yùn)行時用的 JDKProject Structure - Project SDK決定 IDEA 編譯器用的 JDK。把這兩處統(tǒng)一到同一個版本問題就能解決。第二個原因是 IDEA 之前緩存了舊的編譯錯誤。明明配置已經(jīng)修正但點(diǎn)運(yùn)行還是報同樣的錯。這時不要糾結(jié)直接Build - Rebuild Project如果還是不行就Invalidate Caches。4.5 完全沒有網(wǎng)絡(luò)時怎么裝 Lombok 插件有些公司開發(fā)環(huán)境是不允許外網(wǎng)的IDEA 默認(rèn)的插件市場連不上。這時你可以用離線安裝。先在能上網(wǎng)的機(jī)器上從 JetBrains 插件市場頁面下載 Lomobok 插件的 zip 包。注意要選和你 IDEA 版本匹配的版本IDEA 插件市場會按你的 IDEA 版本過濾。下載后拷貝到離線機(jī)器在 IDEA 里打開Settings - Plugins點(diǎn)擊右上角的齒輪按鈕選擇Install Plugin from Disk...選中 zip 包后安裝重啟即可。如果你用的 IDEA 是 2020.1 及以上版本那么 Lombok 插件本身就在 IDEA 安裝目錄的plugins子目錄里。去安裝目錄下找找有沒有l(wèi)ombok或lombok-plugin文件夾。如果有說明插件存在只是沒有被啟用直接在插件列表里啟用就行不需要下載。5. 一些容易踩的深層坑5.1 注解處理器配置錯誤導(dǎo)致其他注解也失效有人為了讓 Lombok 生效手動修改了注解處理器設(shè)置結(jié)果導(dǎo)致 Spring Boot 的ConfigurationProperties或者ComponentScan處理器也出了問題。因?yàn)锳nnotation Processors配置里可以自定義處理器路徑如果你誤加了其他不相關(guān)的處理器編譯器會發(fā)生沖突。我個人推薦的做法勾選Enable annotation processing和Obtain processors from project classpath就夠了不要手動在處理器列表里添加任何全限定類名。Lombok 的處理器類一般是lombok.launch.AnnotationProcessorHider$AnnotationProcessor它會在 classpath 中自動被發(fā)現(xiàn)。除非你有非常特殊的自定義處理器否則保持默認(rèn)就是最穩(wěn)的。5.2 多個 Lombok 版本同時存在如果你的本地 Maven 倉庫中既有 1.18.22 又有 1.18.30且項(xiàng)目依賴沖突導(dǎo)致 IDEA 選擇了錯誤版本也會出現(xiàn)奇怪現(xiàn)象。比如明明項(xiàng)目 pom 里寫了 1.18.30但 IDEA 的編譯日志里顯示使用的是另一個版本。這種情況需要檢查依賴樹mvn dependency:tree -Dincludesorg.projectlombok:lombok看到輸出后確認(rèn)項(xiàng)目最終解析出來的版本是什么。如果發(fā)現(xiàn)是舊的傳遞依賴可以在 pom.xml 中對直接聲明的依賴強(qiáng)制指定版本。有時候 Spring Boot 父依賴管理的 Lombok 版本可能比最新版低但默認(rèn)是相對穩(wěn)定的。如果確實(shí)遇上 JDK 新版本兼容問題可以在properties中顯式覆蓋properties lombok.version1.18.30/lombok.version /properties5.3 在 Java 模塊化項(xiàng)目里使用 Lombok如果你在用 Java 9 以上的模塊化項(xiàng)目module-info.java里需要聲明requires lombok;嗎不需要也不應(yīng)該。Lombok 只在編譯期工作它不進(jìn)入運(yùn)行模塊圖。如果在模塊描述文件里增加 Lombok 依賴反而可能導(dǎo)致模塊解析異常。正確的做法是在模塊描述文件中忽略 Lombok保持它在requires之外并且依賴作用域設(shè)置為provided。在 Spring Boot 的實(shí)際場景中絕大多數(shù)項(xiàng)目沒有使用模塊化所以這個問題并不常見但如果你在搞一些比較新的工程結(jié)構(gòu)可以留個印象。5.4 編譯時 Lombok 生效但運(yùn)行時報 NoSuchMethodError還有一種少見但讓人頭疼的情況代碼編譯通過了運(yùn)行期啟動 Spring Boot 時某個類報NoSuchMethodError提示找不到getXXX方法。這種多半是目標(biāo) class 文件沒有真正包含編譯期生成的方法但 IDEA 編譯時又沒有報錯。我遇到過一次是因?yàn)槟K編譯順序問題一個模塊里的target/classes沒有及時更新導(dǎo)致運(yùn)行時加載的 class 是舊版本。解決辦法是把項(xiàng)目徹底mvn clean一次然后重新 compile。在 IDEA 里可以執(zhí)行Build - Rebuild Project清理所有模塊的編譯輸出避免臟 class 遺留。6. 繞不開的 IDE 版本差異6.1 社區(qū)版 vs 商業(yè)版對 Lombok 的支持差異很多初學(xué)者用的 IDEA Community 版擔(dān)心是不是因?yàn)樯鐓^(qū)版導(dǎo)致 Lombok 失效。其實(shí)不是。Lombok 插件對社區(qū)版和商業(yè)版的底層支持是一樣的。但社區(qū)版不支持 Spring Initializr 項(xiàng)目向?qū)Ю锏哪承┕δ鼙热缧陆?xiàng)目時自動加入 Spring Boot 相關(guān)依賴這會導(dǎo)致你無法在向?qū)е兄苯庸催x Lombok。如果你用了社區(qū)版那么可以在創(chuàng)建完普通項(xiàng)目后手動在 pom.xml 中添加依賴。其他步驟不變。所以不要再懷疑是社區(qū)版的問題了Lombok 本身和 IDE 版本無關(guān)JVM 和編譯器才相關(guān)。6.2 IDEA 2023/2024 版本的新改動在最新幾個版本里JetBrains 把 Lombok 插件邏輯整合到了Dependencies的分析中。如果你打開Project Structure - Facets可能會看到 Spring 和 Lombok 的標(biāo)識。這些改動或許會帶來一些 UI 上的陌生感但核心設(shè)置路徑基本沒變。在 2024.1 及以后版本中Compiled classes output的路徑結(jié)構(gòu)有所調(diào)整但注解處理的開關(guān)位置仍然在原來的菜單里。如果你找不到可以直接在設(shè)置窗口左上角搜索框輸入 “Annotation”會快速定位。6.3 有些所謂的“IDEA 破解版”也會導(dǎo)致 Lombok 失效這里我必須強(qiáng)調(diào)一句不要使用非官方渠道的激活方式。且不談版權(quán)問題破解版的 IDEA 往往修改了核心 jar 包插件加載機(jī)制可能被破壞導(dǎo)致 Lombok 插件無法正確注冊為編譯器插件。很多人遇到“怎么設(shè)置都沒用”的疑難雜癥最后發(fā)現(xiàn)是因?yàn)橛昧瞬灰?guī)范的 IDEA 安裝包。我建議直接去 JetBrains 官網(wǎng)下載官方安裝包社區(qū)版就完全免費(fèi)。實(shí)在需要付費(fèi)功能的可以評估一下是否真的需要商業(yè)版或者使用開源替代品。在你的開發(fā)工具上穩(wěn)定性和可維護(hù)性永遠(yuǎn)是最優(yōu)先的。7. 最后再分享兩個小技巧第一個技巧是如果你在 IDEA 里怎么折騰都搞不定但 Maven 命令行編譯是正常的那就別再死磕 IDEA 編譯按鈕了?？梢栽赟ettings - Build, Execution, Deployment - Build Tools - Maven - Runner中勾選Delegate IDE build/run actions to Maven。這樣 IDEA 的構(gòu)建和運(yùn)行操作會直接轉(zhuǎn)交給 Maven 處理相當(dāng)于繞開了 IDEA 內(nèi)置編譯器。在這個模式下只要 Maven 能編譯過IDEA 里運(yùn)行 Spring Boot 項(xiàng)目也就沒問題。這個技巧尤其適合那些 IDEA 內(nèi)置編譯器就是和 Lombok 八字不合的極端環(huán)境。第二個技巧是使用 Lombok 時盡量讓實(shí)體類保持簡潔。Data雖然把 getter/setter/toString/equals/hashCode 全包了但在某些復(fù)雜業(yè)務(wù)場景下equals和hashCode的生成規(guī)則可能會拖垮性能。如果你只需要簡單的賦值和取值可以用Getter和Setter如果你不想生成 equals 和 hashCode可以單獨(dú)用Getter Setter ToString而不要無腦Data。這和本次的報錯主題無關(guān)但既然是聊 Lombok順手提醒一下開發(fā)者們養(yǎng)成習(xí)慣避免在長期維護(hù)的項(xiàng)目里給自己留坑。我這個環(huán)境里實(shí)際操作過太多次遇到的案例五花八門從最簡單的沒開注解處理到復(fù)雜的 JDK 版本不匹配再到因?yàn)?IDEA 插件國服鏡像問題導(dǎo)致插件安裝失敗。但只要按照插件優(yōu)先、注解處理其次、依賴版本兜底的思路走一遍百分之九十九的問題都能在當(dāng)前環(huán)境內(nèi)消化掉。剩下那百分之一直接使用Delegate IDE build/run actions to Maven這個終極大招就可以安心回代碼邏輯本身了。如果你現(xiàn)在正被這個問題卡著推進(jìn)度照著這篇把Settings一步一步走下來基本十分鐘內(nèi)就能看到編寫區(qū)里的紅色波浪線消失編譯也順利通過。要是還不行請把報錯日志再讀一遍看看是不是出現(xiàn)了ServiceConfigurationError或UnsupportedClassVersionError那些是另一個維度的問題但本文里提到的排查思路依然適用。