youdozi's memory
← 개발 기록

[springboot] springboot intellij-community lombok

youdozi

개요

intellij-community 버전으로 springboot 프로젝트를 import하여 가동하는것 까지 성공했습니다.

참고 - intellij-ce-springboot-import

이제 기쁜 마음으로 코드를 하나 하나 짜보고 있는데..
이 무슨.. lombok이 정상 작동하고 있지 않습니다.
최근 사용한 ultimate 버전에서는 자동으로 lombok plugin이 설치되어 있었는데..
역시 community 입니다. 제가 해줘야 하네요.
이번 시간엔 intellij-community 버전으로 lombok을 사용해보도록 하겠습니다.

lombok plugin 설치

먼저 plugin 설치를 위해 setting 화면으로 이동해 보도록 하겠습니다.

intellij_setting.png

setting -> plugins로 이동합니다.

intellij_setting_plugin.png

intellij plugin 관리 화면이 나옵니다.
여기서 marketplace 탭 -> 텍스트박스에 lombok을 입력합니다.

intellij_setting_plugin_select.png

lombok plugin이 보입니다. lombok을 선택하고 install 버튼을 클릭합니다.
정상적으로 설치 되었다면 installed 탭에서 확인 가능합니다.

lombok_plugin_install_after.png

설치가 마무리 되었습니다.
이제 gradle 종속성 주입을 진행 해보겠습니다.

lombok 종속성 주입

build.gradle에 아래와 같이 lombok 종속성을 주입니다.

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

    testCompileOnly 'org.projectlombok:lombok'
    testAnnotationProcessor 'org.projectlombok:lombok'    
}

testCompileOnly, testAnnotationProcessor는 테스트 환경에서 lombok을 사용할 수 있도록 해줍니다.
필요 없다면 compileOnly, annotationProcessor만 종속성 주입 해주면 됩니다.

하지만 여기가 끝이 아닙니다. lombok 어노테이션이 정상 작동하도록 추가적인 설정이 필요합니다. 아래 부분까지 진행 해 주세요!

lombok annotation 셋팅

다시 한번 더 setting 화면으로 이동해 봅니다.
build, execution, deployment -> compiler -> annotation processors로 이동합니다.

lombok_setting_annotation.png

위 화면처럼 Enable annotation processing을 체크하면 됩니다.

그럼 이제 정상적으로 lombok이 작동 될겁니다!

검증 및 보강 — 2026-10-24

Lombok은 보통 런타임 의존성이 아닌 컴파일 시점의 도구이므로 공식 Gradle 구성에 맞춰 compileOnly와 annotationProcessor로 수정했습니다. 버전을 생략한 예제는 Spring Boot 의존성 관리가 적용되어 있다는 전제입니다. 일반 Gradle 프로젝트는 두 선언에 동일한 Lombok 버전을 명시해야 합니다. IDE가 인식하는 문제와 Gradle 빌드 문제를 분리하려면 먼저 ./gradlew clean compileJava를 실행하세요. IDE 화면과 플러그인 기본 제공 여부는 버전에 따라 달라집니다.

확인한 자료

댓글

함께 읽을 글