概述

在使用 Lombok 簡(jiǎn)化 Java 開(kāi)發(fā)時(shí)，不少開(kāi)發(fā)者在 JDK 9 及以上版本會(huì)遇到如下報(bào)錯(cuò)：class

lombok.javac.apt.LombokProcessor (in unnamed module @0x6971c6b7) cannot access class com.sun.tools.javac.processing.JavacProcessingEnvironment (in module jdk.compiler) because module jdk.compiler does not export com.sun.tools.javac.processing to unnamed module @0x6971c6b7

本文將從報(bào)錯(cuò)根源切入，拆解問(wèn)題本質(zhì)，提供 4 套可落地的解決方案，并補(bǔ)充避坑要點(diǎn)，幫助開(kāi)發(fā)者徹底解決該問(wèn)題。

一、報(bào)錯(cuò)根源：JDK 模塊化與 Lombok 的核心沖突

要解決報(bào)錯(cuò)，需先理解兩個(gè)關(guān)鍵技術(shù)點(diǎn)的交互邏輯：

1. JDK 9 + 的模塊化機(jī)制：從 “開(kāi)放” 到 “隔離”

JDK 8 及之前版本，Java 類(lèi)加載采用 “全局可見(jiàn)” 模式，JDK 內(nèi)部類(lèi)（如com.sun.tools.javac相關(guān)類(lèi)）可被外部代碼直接訪問(wèn)。但從 JDK 9 開(kāi)始，Java 引入模塊化系統(tǒng)（Module System），核心目標(biāo)是實(shí)現(xiàn) “代碼隔離”：

• JDK 按功能拆分為多個(gè)獨(dú)立模塊（如負(fù)責(zé)編譯的jdk.compiler、負(fù)責(zé)基礎(chǔ)功能的jdk.base）；
• 每個(gè)模塊通過(guò)module-info.java明確聲明 “對(duì)外暴露的包” 和 “依賴(lài)的模塊”；
• 未聲明 “導(dǎo)出” 的內(nèi)部包（如jdk.compiler下的com.sun.tools.javac.processing），默認(rèn)拒絕外部訪問(wèn)。

2. Lombok 的運(yùn)行原理：依賴(lài) JDK 內(nèi)部編譯類(lèi)

Lombok 并非普通 Java 庫(kù)，其核心能力（如@Data自動(dòng)生成 getter/setter、@Slf4j創(chuàng)建日志對(duì)象）依賴(lài)Java 編譯時(shí)注解處理器（APT）：

• 編譯階段，Lombok 通過(guò)lombok.javac.apt.LombokProcessor介入javac編譯器流程；
• 需訪問(wèn)com.sun.tools.javac.processing.JavacProcessingEnvironment（javac內(nèi)部管理注解處理器的核心類(lèi)），才能修改抽象語(yǔ)法樹(shù)（AST），實(shí)現(xiàn) “少寫(xiě)代碼” 的效果。

沖突點(diǎn)：JDK 9 + 的jdk.compiler模塊未 “導(dǎo)出”com.sun.tools.javac.processing包，而 Lombok 默認(rèn)處于 “無(wú)名模塊（unnamed module）” 中，無(wú)法訪問(wèn)該內(nèi)部包，最終觸發(fā)權(quán)限報(bào)錯(cuò)。

二、4 套解決方案：從簡(jiǎn)單到進(jìn)階（優(yōu)先級(jí)排序）

根據(jù)項(xiàng)目實(shí)際場(chǎng)景（Lombok 版本、JDK 版本、構(gòu)建工具），可選擇以下方案，推薦優(yōu)先嘗試前兩種。

方案一：升級(jí) Lombok 到最新版本（首選無(wú)侵入方案）

Lombok 團(tuán)隊(duì)已針對(duì) JDK 模塊化問(wèn)題持續(xù)適配，從1.18.16版本開(kāi)始，通過(guò)優(yōu)化內(nèi)部邏輯減少對(duì) JDK 內(nèi)部類(lèi)的依賴(lài)，或通過(guò)合規(guī)方式訪問(wèn)，直接規(guī)避報(bào)錯(cuò)。這是最簡(jiǎn)單、最穩(wěn)定的解決方案。

操作步驟：

• 查看當(dāng)前 Lombok 版本在pom.xml（Maven）或build.gradle（Gradle）中找到 Lombok 依賴(lài)，確認(rèn)當(dāng)前版本（如舊版本1.18.10需升級(jí)）。
• 替換為最新穩(wěn)定版本訪問(wèn)Lombok 官方 Maven 倉(cāng)庫(kù)，獲取最新版本（截至 2024 年，最新穩(wěn)定版為1.18.30），替換依賴(lài)配置。

Maven 項(xiàng)目示例：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version> <!-- 替換為最新版本 -->
    <scope>provided</scope> <!-- 編譯時(shí)依賴(lài)，不打包到最終產(chǎn)物 -->
</dependency>

Gradle 項(xiàng)目示例：

dependencies {
    provided 'org.projectlombok:lombok:1.18.30' // 編譯時(shí)依賴(lài)
    annotationProcessor 'org.projectlombok:lombok:1.18.30' // 必須配置注解處理器
}

驗(yàn)證效果Maven 執(zhí)行mvn clean compile，Gradle 執(zhí)行gradle clean build，若編譯通過(guò)，報(bào)錯(cuò)已解決。

方案二：添加 JVM 編譯參數(shù)，顯式 “導(dǎo)出” 內(nèi)部包

若因項(xiàng)目依賴(lài)限制（如必須使用舊版本 Lombok）無(wú)法升級(jí)，可通過(guò)JVM 參數(shù)強(qiáng)制jdk.compiler導(dǎo)出內(nèi)部包，打破模塊化訪問(wèn)限制。

不同構(gòu)建工具的配置方式：

1. Maven 項(xiàng)目：配置maven-compiler-plugin

在pom.xml的build/plugins節(jié)點(diǎn)下添加插件，指定編譯參數(shù)：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 適配JDK 9+的最低版本 -->
            <configuration>
                <source>17</source> <!-- 與項(xiàng)目JDK版本一致（如JDK 17） -->
                <target>17</target>
                <encoding>UTF-8</encoding>
                <compilerArgs>
                    <!-- 核心參數(shù)：允許jdk.compiler導(dǎo)出內(nèi)部包給所有無(wú)名模塊 -->
                    <arg>--add-exports=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED</arg>
                    <!-- 若后續(xù)出現(xiàn)其他內(nèi)部類(lèi)報(bào)錯(cuò)，可追加類(lèi)似參數(shù)，例如：
                    <arg>--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED</arg>
                    -->
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

2. Gradle 項(xiàng)目：配置compileJava任務(wù)

在build.gradle中添加編譯參數(shù)：

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
    sourceCompatibility = JavaVersion.VERSION_17 // 與項(xiàng)目JDK一致
    targetCompatibility = JavaVersion.VERSION_17
    // 添加JVM參數(shù)
    options.compilerArgs += [
        '--add-exports=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED'
    ]
}

3. IDE 臨時(shí)配置（測(cè)試用）

若需在 IDE 中快速驗(yàn)證，可直接配置編譯參數(shù)：

• IntelliJ IDEA：File > Settings > Build > Compiler > Java Compiler，在 “Additional command line parameters” 中輸入上述參數(shù)，重建項(xiàng)目。
• Eclipse：Project > Properties > Java Compiler > Annotation Processing，勾選 “Enable annotation processing”，并在 “Factory Path” 添加 Lombok JAR 包，同時(shí)補(bǔ)充上述參數(shù)。

方案三：修復(fù) IDE 的 Lombok 配置（排除環(huán)境問(wèn)題）

有時(shí)報(bào)錯(cuò)并非代碼 / 依賴(lài)問(wèn)題，而是 IDE 的 Lombok 插件或注解處理功能未正確配置，導(dǎo)致處理器無(wú)法運(yùn)行。需從 3 點(diǎn)排查：

1. 確認(rèn) IDE 已安裝 Lombok 插件

• IntelliJ IDEA：File > Settings > Plugins，搜索 “Lombok”，確認(rèn)已安裝并啟用（安裝后需重啟 IDE）。
• Eclipse：Help > Eclipse Marketplace，搜索 “Lombok” 安裝，重啟后生效。

2. 啟用 “注解處理” 功能

Lombok 依賴(lài)注解處理器工作，若未啟用會(huì)導(dǎo)致處理器加載失?。?/p>

• IntelliJ IDEA：File > Settings > Build > Annotation Processors，勾選 “Enable annotation processing”。
• Eclipse：Project > Properties > Java Compiler > Annotation Processing，勾選 “Enable annotation processing”。

3. 統(tǒng)一 IDE 與項(xiàng)目的 JDK 版本

若 IDE 使用的 JDK 與項(xiàng)目配置不一致（如項(xiàng)目用 JDK 17，IDE 用 JDK 8），會(huì)觸發(fā)模塊化適配問(wèn)題：

• IntelliJ IDEA：File > Project Structure > Project，將 “Project SDK” 改為項(xiàng)目使用的 JDK 版本。

方案四：降級(jí) JDK 到 8 版本（應(yīng)急方案，不推薦）

若上述方案均無(wú)法實(shí)施，可臨時(shí)將 JDK 降級(jí)到 JDK 8——JDK 8 無(wú)模塊化機(jī)制，com.sun.tools.javac.processing包可直接訪問(wèn)，不會(huì)報(bào)錯(cuò)。

注意事項(xiàng)：

• JDK 8 已于 2026 年停止 Oracle 官方支持，長(zhǎng)期使用存在安全風(fēng)險(xiǎn)；
• 降級(jí)前需確認(rèn)項(xiàng)目無(wú) JDK 9 + 特性（如模塊化語(yǔ)法、接口私有方法），避免新的兼容性問(wèn)題。

三、避坑指南：解決后的關(guān)鍵注意事項(xiàng)

1. 優(yōu)先升級(jí) Lombok，拒絕 “繞過(guò)” 機(jī)制添加--add-exports參數(shù)本質(zhì)是 “繞過(guò)” JDK 模塊化規(guī)則，若未來(lái) JDK 調(diào)整內(nèi)部包結(jié)構(gòu)（如移除com.sun.tools.javac.processing），該參數(shù)會(huì)失效；而升級(jí) Lombok 是官方適配方案，兼容性更強(qiáng)。

2. 避免 Lombok 版本沖突若項(xiàng)目中多個(gè)依賴(lài)間接引入不同版本 Lombok（如 A 依賴(lài)用 1.18.10，B 依賴(lài)用 1.18.30），會(huì)導(dǎo)致處理器加載異常。可通過(guò)以下命令查看依賴(lài)樹(shù)，排除舊版本：

   • Maven：mvn dependency:tree | grep lombok
   • Gradle：gradle dependencies | grep lombok

3. JDK 17 + 的額外適配JDK 17 對(duì)內(nèi)部 API 限制更嚴(yán)格，舊版本 Lombok（如 1.18.22 以下）即使添加--add-exports也可能報(bào)錯(cuò)，需確保 Lombok 版本≥1.18.22。

四、總結(jié)

Lombok 報(bào)錯(cuò) “無(wú)法訪問(wèn) jdk.compiler 內(nèi)部類(lèi)” 的核心是JDK 9 + 模塊化與 Lombok 運(yùn)行依賴(lài)的沖突。解決問(wèn)題的最優(yōu)路徑是：

1. 優(yōu)先升級(jí) Lombok 到最新版本；
2. 若無(wú)法升級(jí)，添加 JVM 編譯參數(shù)導(dǎo)出內(nèi)部包；
3. 最后排查 IDE 配置，確保插件與注解處理功能正常。

在 Java 生態(tài)升級(jí)的背景下，保持 Lombok 與 JDK 版本同步，是避免此類(lèi)兼容性問(wèn)題的長(zhǎng)期策略。

到此這篇關(guān)于Lombok 報(bào)錯(cuò)：無(wú)法訪問(wèn) jdk.compiler 內(nèi)部類(lèi)的解決方案的文章就介紹到這了,更多相關(guān)Lombok無(wú)法訪問(wèn) jdk.compiler 內(nèi)部?jī)?nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論