2025/7/15 - 빌드 에러 (콕플 프로젝트)

배포를 위해 도커 이미지를 빌드하고 ECR에 푸쉬하기 전, Gradle로 빌드를 하려는 중에 발생한 오류이다. ./gradlew clean build 명령어를 실행했을 때, 컴파일은 정상적으로 진행되었으나 :test작업에서 빌드가 실패했다.

• 원인: 핵심적인 원인은 IntelliJ에서 애플리케이션을 실행하는 환경과 Gradle이 터미널에서 빌드(테스트)를 실행하는 환경이 분리되어있다는 점이다. 현재 IntelliJ의 실행 구성(Run Configuration)에 직접 설정한 환경 변수로 DB접속 정보를 저장해둔 상태인데, 그렇기에 터미널에서의 빌드 환경에서는 환경 변수를 인지하지 못해 application.yml에서 DB접속 정보를 읽지 못하고 **PersistenceException**이 발생한 것이다.

<aside> ⚠️

• > Task :test FAILED: 테스트 코드를 실행하는 :test 단계에서 문제가 발생

• Caused by: jakarta.persistence.PersistenceException: PersistenceException은 JPA(Java Persistence API), 즉 데이터베이스 연동 기술과 관련된 문제가 발생했을 때 나타나는 예외

• Caused by: java.lang.RuntimeException at DriverDataSource.java: DriverDataSource는 Spring이 데이터베이스에 실제 연결을 시도할 때 사용하는 클래스로, 이 예외는 데이터베이스에 접속을 시도했지만 연결이 실패했다는 의미 </aside>

• 해결 방안:

  1. ./gradlew clean build -x test로 테스트 작업을 건너뛰고 빌드를 진행하여 DB 연결 오류 없이 빌드가 성공적으로 완료했다. 이를 통해 생성된 .jar 파일을 사용하여 Docker 이미지를 정상적으로 빌드하고 ECR에 푸시할 수 있었다.
  2. application.yml에 DB접속 정보를 명시해두는 방법으로도 해결이 가능하다. Gradle 테스트 환경이 Docker 컨테이너의 DB에 접속할 수 있도록 설정함으로써 빌드를 성공적으로 완료할 수 있다.
  3. 현재는 임시 방편으로 1번 방법을 사용했지만 장기적으로는 테스트 환경의 데이터베이스 설정을 구성하는 것이 좋을 것 같다. 외부 DB에 의존하지 않도록, 테스트 시에는 H2 데이터베이스를 사용하도록 구성하는 것이다.

2025/7/29 - 빌드 에러 (콕플 프로젝트)

QueryDSL 설정을 추가하고 ./gradlew clean build 명령어로 빌드를 시도하는 중에 발생한 오류이다. 컴파일은 정상적으로 진행되었으나, :test 작업에서 새로 추가된 QueryDSL 관련 테스트 코드가 실행되면서 빌드가 실패했다.

• 원인: 핵심적인 원인은 테스트 환경에 데이터베이스(DB) 구성이 올바르게 되어있지 않았기 때문이다. 실제 애플리케이션은 application.yml에 명시된 환경 변수를 통해 외부 DB에 정상적으로 접속하지만, 테스트 환경에서는 이 정보를 알 수 없다. 따라서 QueryDSL을 사용하는 테스트 코드가 DB에 연결을 시도하는 순간, 유효한 **DataSource**를 찾지 못해 예외가 발생하고 테스트가 실패합니다.

<aside> ⚠️

• Caused by: org.springframework.util.PlaceholderResolutionException: application.yml의 ${SPRING_DATASOURCE_URL}과 같은 설정 값(Placeholder)을 찾지 못했다는 의미입니다. </aside>

• 해결 방안:

  1. ./gradlew clean build -x test로 테스트 작업을 건너뛰고 빌드를 진행하여 DB 연결 오류 없이 빌드가 성공적으로 완료했다.
  2. 테스트 시에는 외부 DB가 아닌, H2 데이터베이스를 사용하도록 구성한다. 또한 S3 관련 설정에 테스트용 더미 값을 넣어 Placeholder 예외를 방지한다.