[Java] Lombok 업그레이드로 IllegalAccessError 해결하기 (Java 17+)

joyful·2026년 1월 14일

Java/Spring

목록 보기
30/47

❌ 문제 상황

Gradle 빌드 중 아래와 같은 에러가 발생했다.

Execution failed for task ':compileJava'.

java.lang.IllegalAccessError:
class lombok.javac.apt.LombokProcessor cannot access
class com.sun.tools.javac.processing.JavacProcessingEnvironment

🔍 원인

Java 9부터 모듈 시스템(JPMS)이 도입되면서 jdk.compiler 모듈 내부의 javac 관련 클래스 접근이 제한되었다.

Lombok은 컴파일 시 javac 내부 API에 접근하는데, Lombok 버전이 오래된 경우 이 접근이 차단되며 에러가 발생한다.

즉, Java 버전과 Lombok 버전의 불일치로 인해 발생하는 문제로, 특히 Java 17 / 21 환경에서 자주 발생한다.


✅ 해결 방법

Gradle 기준으로 Lombok을 최신 버전(1.18.28 이상)으로 업데이트 한다.

dependencies {
	compileOnly 'org.projectlombok:lombok:1.18.30'
	annotationProcessor 'org.projectlombok:lombok:1.18.30'
}
profile
기쁘게 코딩하고 싶은 백엔드 개발자

0개의 댓글