[JPA] 에러 Attempt to recreate a file for type ...

QueryDSL을 사용하는 프로젝트에서 빌드 과정 중에 자주 발생하는 에러인데 정리해서 다음에는 바로 수정할 수 있도록 하겠습니다.

오류 상황

QueryDSL을 사용하여 엔티티에 대한 Q타입 클래스 파일들을 자동 생성하는 과정에서, 이미 생성된 Q타입 클래스 파일을 다시 생성하려 할 때 발생하는 오류입니다. 오류 메시지는 다음과 같습니다:

Attempt to recreate a file for type org.jake.spring.entity.QAnster
Attempt to recreate a file for type org.jake.spring.entity.QMember

이는 QAnster와 QMember 같은 Q객체 파일들이 이미 생성되었는데, 빌드 과정에서 이 파일들을 다시 생성하려고 하면서 발생하는 문제입니다.

원인

QueryDSL은 엔티티 클래스를 기반으로 Q타입의 클래스 파일들을 생성합니다. 이 파일들은 쿼리 작성 시 타입 안전성을 제공합니다. 프로젝트 빌드 시, 이전에 생성된 Q타입 클래스 파일들이 삭제되지 않고 남아 있으면, 동일한 파일을 다시 생성하려고 할 때 오류가 발생합니다.

해결 방법

해당 문제를 해결하기 위한 방법은 다음과 같습니다:

1. build 하위 폴더 삭제: 프로젝트의 build/generated 폴더를 삭제합니다. 이 폴더 안에는 QueryDSL에 의해 자동 생성된 Q타입 클래스 파일들이 위치합니다. 폴더를 삭제함으로써, 이전에 생성된 파일들을 제거할 수 있습니다.
2. gradle build -> clean: Gradle 빌드 툴을 사용한다면, Gradle의 clean 태스크를 실행하여 이전 빌드 때 생성된 파일들을 모두 삭제할 수 있습니다. 이 작업은 프로젝트를 깨끗한 상태로 만들어 줍니다.
3. gradle other -> compileJava: 마지막으로, compileJava 태스크를 실행하여 프로젝트를 다시 컴파일합니다. 이 과정에서 QueryDSL에 의해 필요한 Q타입 클래스 파일들이 다시 생성됩니다.
   
   

Gradle other compileJava 를 실행한다

실행 방법

Gradle을 사용하는 경우, 터미널이나 커맨드 라인에서 다음 명령어를 순서대로 실행하면 됩니다: 

./gradlew clean
./gradlew compileJava

위 명령어는 Unix/Linux/macOS 시스템에서의 예시이며, Windows에서는 gradlew 대신 gradlew.bat을 사용합니다.

 

(클릭으로 하실분들은 아래 참고)

 

generated 폴더를 삭제한다

 

결론

QueryDSL을 사용하는 프로젝트에서 빌드 과정 중에 발생할 수 있는 오류를 해결하기 위해, build/generated 폴더를 삭제하거나 Gradle의 clean 태스크를 통해 이전 빌드 파일들을 정리하는 과정이 필요합니다. 이를 통해 프로젝트를 원활하게 빌드하고, QueryDSL의 Q타입 클래스 파일들을 정상적으로 생성할 수 있습니다.