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 예외를 방지한다.

2025/9/11 - 포트 충돌 (콕플 프로젝트)

로컬로 Spring Boot 웹 애플리케이션 개발할 때, 간단하지만 자주 발생하는 오류이기에 최적화된 해결 방법을 알아보고자 정리하려고 한다. 이 경우 다른 애플리케이션이 해당 포트를 점거하고 있기에 발생하는 오류로 기존에 실행했던 Spring Boot 애플리케이션이 제대로 종료되지 않고 백그라운드에서 계속 실행 중일 때 주로 발생한다.

<aside> ⚠️

• Web server failed to start. Port 8080 was already in use. </aside>

• 해결 방안:

  1. 기존에 실행 중인 프로세스 종료하기

     → 명령 프롬프트에서 netstat -ano | findstr 8080로 PID 확인

     → taskkill /F /PID [확인한 PID 번호]

  2. 기존에 사용 중인 포트를 계속해서 사용해야 한다면 다른 포트를 사용하도록 변경

     → application.yml에서 server: port: 8081

2025/9/24 - index.jsp not found 문제 (KB국민은행 오픈소스)

****“KB국민은행 - 금융 교육 및 연습 웹 서비스” 오픈소스를 개선하는 프로젝트를 진행하면서 발생한 오류로 서버를 정상적으로 실행했으나, 뷰(JSP) 리소스를 못 찾아서 404 에러가 발생했다.

• 원인: 컨트롤러에서 index 뷰를 리턴했는데, 해당 JSP 파일을 경로에서 찾지 못하여 발생한 오류이다.