Spring Boot Testcontainers 실전: PostgreSQL/Redis 통합테스트를 CI에서 안정화하기

Spring Boot Testcontainers 실전: PostgreSQL/Redis 통합테스트를 CI에서 안정화하기

Testcontainers는 '내 컴퓨터에서는 되는데 CI에서는 실패'를 줄여주는 통합테스트 표준 패턴이라 검색 유입이 꾸준합니다. 이 글은 Spring Boot에서 Postgres/Redis 컨테이너를 기반으로 통합테스트를 안정화하는 포인트를 정리합니다.

컨테이너 기반 통합테스트는 환경 차이를 줄여 회귀를 빨리 잡습니다.

옵션/핵심 요소(3~6개)

항목	의미	언제 쓰는지(실무 상황)
PostgreSQLContainer	DB 컨테이너	마이그레이션+JPA까지 포함한 검증
Redis 컨테이너	캐시/락 검증	운영과 동일한 Redis 동작을 테스트
CI Docker	실행 환경	러너에서 Docker 사용 가능 여부 확인
랜덤 포트	충돌 방지	포트 충돌을 회피
로그 수집	원인 파악	컨테이너 로그로 실패 원인 단축

예시(개념)

// 개념 예시
val postgres = PostgreSQLContainer('postgres:16-alpine')
postgres.start()
// datasource 설정에 postgres.jdbcUrl 등을 주입

문제 상황(정확히 1개)

상황: 로컬에서는 통과하는데 CI에서만 Testcontainers가 시작 실패/타임아웃으로 실패한다

원인: CI 러너에서 Docker 접근 권한이 없거나 네트워크/리소스 제한으로 컨테이너 기동이 불안정하다

해결: Docker 가능한 러너로 변경하고, 통합테스트를 별도 잡으로 분리해 실행하며 실패 시 컨테이너 로그를 남긴다

예방 팁: CI에서 Testcontainers 실행 여부를 명시적으로 분리하고, smoke test로 컨테이너 기동을 먼저 검증한다

참고/출처

• Testcontainers Docs