java.lang.IllegalAccessError: LombokProcessor が JavacProcessingEnvironment にアクセスできない問題の解決方法

問題の概要

Java で Project Lombok を使用している際、以下のエラーが発生することがあります：

java.lang.IllegalAccessError: class lombok.javac.apt.LombokProcessor (in unnamed module @0x3b67ef9b) 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 @0x3b67ef9b

このエラーは、Java のモジュールシステムが導入された JDK 9 以降で発生するもので、特に OpenJDK 15 以降で頻発します。Lombok が内部的に使用している com.sun.tools.javac.processing.JavacProcessingEnvironment クラスへのアクセスが、モジュールのエクスポート設定によって制限されていることが原因です。

解決方法

方法 1: Lombok の最新バージョンを使用する（推奨）

最も簡単で効果的な解決策は、Lombok を バージョン 1.18.22 以上にアップデートすることです。このバージョン以降、Java 16 以降との互換性問題が修正されています。

Maven の pom.xml で Lombok の依存関係を更新します：

xml

<dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
  <version>1.18.28</version>
  <scope>provided</scope>
</dependency>

最新バージョンの確認

Lombok の最新バージョンは Maven Central Repository で確認できます。

方法 2: Maven コンパイラプラグインの設定を追加する

Lombok のバージョンアップが難しい場合や、特定の事情で古いバージョンを使用する必要がある場合は、Maven コンパイラプラグインに追加の引数を設定することで問題を回避できます。

xml

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.1</version>
  <configuration>
    <source>16</source>
    <target>16</target>
    <fork>true</fork>
    <compilerArgs>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.jvm=ALL-UNNAMED</arg>
    </compilerArgs>
    <annotationProcessorPaths>
      <path>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.16</version>
      </path>
    </annotationProcessorPaths>
  </configuration>
</plugin>

注意

この方法は一時的な回避策であり、Lombok のバージョンアップを推奨します。また、IntelliJ IDEA などの特定の IDE では、この設定と競合する可能性があります。

方法 3: Lombok を使用せずに手動で実装する

どうしても問題が解決しない場合や、Lombok への依存を避けたい場合は、Lombok のアノテーションが生成するコードを手動で実装することも選択肢です。

例として、@Data アノテーションは以下の機能を提供します：

java

// @Data アノテーションは以下と同等
@Getter
@Setter
@ToString
@EqualsAndHashCode
@RequiredArgsConstructor
public class Ingredient {
    private final String id;
    private final String name;
    private final Type type;
    
    public enum Type {
        WRAP, PROTEIN, VEGGIES, CHEESE, SAUCE
    }
}

これらのアノテーションを個別に使用するか、または完全に手動で getter/setter メソッドを実装することもできます。

根本原因

この問題は、Java 9 で導入されたモジュールシステム（JPMS）に起因しています。Java 16 では、内部APIへのアクセス制限がより厳格化され、Lombok がコンパイラの内部処理にアクセスするために使用していた com.sun.tools.javac パッケージがデフォルトでエクスポートされなくなりました。

まとめ

解決方法	推奨度	注意点
Lombok の最新化	⭐⭐⭐⭐⭐	最も簡単で安全な方法
コンパイラ設定の追加	⭐⭐	一時的な回避策、環境によって動作しない可能性あり
Lombok 不使用	⭐	コードの記述量が増加する

推奨アプローチ

Lombok をバージョン 1.18.22 以上に更新することを強く推奨します。これは最もクリーンな解決策であり、将来的な互換性問題も最小限に抑えられます。

最新の開発環境では、常に使用しているライブラリのバージョンを最新に保つことが、この種の問題を回避する最良の方法です。

関連記事

java.lang.IllegalAccessError: LombokProcessor が JavacProcessingEnvironment にアクセスできない問題の解決方法 ​

問題の概要 ​

解決方法 ​

方法 1: Lombok の最新バージョンを使用する（推奨） ​

方法 2: Maven コンパイラプラグインの設定を追加する ​

方法 3: Lombok を使用せずに手動で実装する ​

根本原因 ​

まとめ ​