🚀 TDD부터 Testcontainers까지...

TDD(Test Driven Development)의 개념부터 Testcontainers가 왜 등장했는지 그리고 특정 버전과 호환되지 않아 발생하는 실제 문제와 해결 전략까지 정리해본다.

1️⃣ TDD(Test Driven Development)란?

TDD는 테스트를 먼저 작성하고 그 테스트를 통과하는 코드를 작성하는 개발 방식이다.

TDD의 기본 사이클 (Red → Green → Refactor)

1. Red
   • 실패하는 테스트를 먼저 작성
2. Green
   • 테스트를 통과시키는 최소한의 코드 작성
3. Refactor
   • 중복 제거, 구조 개선

2️⃣ TDD 장단점

✅ 장점

• 요구사항이 코드로 명확해진다 ⭐⭐⭐
• 회귀 버그 방지

❌ 단점

• 초기 개발 속도가 느리다
• 테스트 작성에 대한 러닝 커브 ⭐⭐
• 외부 의존성(DB, Redis, Kafka 등)이 많을수록 난이도 증가 ⭐⭐⭐

👉 이 지점에서 Testcontainers가 등장한다.

3️⃣ 기존 테스트 방식의 한계

보통 이런 방식으로 테스트를 작성해왔다.

• H2 같은 In-memory DB 사용
• 로컬 DB에 직접 의존
• 개발자마다 다른 환경 ⭐⭐⭐

👉 운영 환경과 테스트 환경의 불일치가 가장 큰 문제다.

4️⃣ Testcontainers란?

Testcontainers는 테스트 코드에서 Docker 컨테이너를 직접 띄워 사용하는 라이브러리다.

핵심 개념

• 테스트 실행 시
  • 실제 DB / 메시지 브로커 / 인메모리 캐시 ... 등 컨테이너 실행 ⭐⭐
  • 테스트 종료 후 자동 정리
• 운영 환경과 동일한 버전 사용 가능

5️⃣ Testcontainers 기본 사용 예 (Spring Boot + JUnit + Java/Kotlin)

Gradle 의존성 및 Configuration

testImplementation("org.testcontainers:junit-jupiter")
testImplementation("org.testcontainers:mariadb")


-------------

@Testcontainers
@ActiveProfiles("test")
public abstract class TestContainerConfig {

    @Container
    protected static final MariaDBContainer<?> mariaDBContainer = new MariaDBContainer<>("mariadb:latest")
            .withDatabaseName(TestDBConfig.DB_NAME)
            .withUsername(TestDBConfig.USERNAME)
            .withPassword(TestDBConfig.PASSWORD);

    @DynamicPropertySource
    static void overrideProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", mariaDBContainer::getJdbcUrl);
        registry.add("spring.datasource.username", mariaDBContainer::getUsername);
        registry.add("spring.datasource.password", mariaDBContainer::getPassword);
    }
}

❗Testcontainers 문제 발생

Could not find a valid Docker environment. Please see logs and check configuration 라는 오류가 갑자기 잘되다가 발생

Caused by: java.lang.IllegalStateException: Could not find a valid Docker environment. Please see logs and check configuration
    at org.testcontainers.dockerclient.DockerClientProviderStrategy.lambda$getFirstValidStrategy$7(DockerClientProviderStrategy.java:274)
    at java.base/java.util.Optional.orElseThrow(Optional.java:403)
    at org.testcontainers.dockerclient.DockerClientProviderStrategy.getFirstValidStrategy(DockerClientProviderStrategy.java:265)

🚨 1. Docker CLI 버전 문제

❌ Docker 29.x 버전과 호환문제

✅ 해결 방법

• Docker Desktop 28.x 이하 버전 사용
• Spring Boot 3.5.8 이상으로 업그레이드
• docker.sock 경로 수정

sudo ln -s $HOME/.docker/run/docker.sock /var/run/docker.sock

6️⃣ Testcontainers 장점

• 실제 DB 동작과 100% 동일 ⭐⭐
• CI/CD 환경에서도 재현 가능
• 로컬 환경 오염 없음 ⭐⭐⭐
• 테스트 간 독립성 보장 ⭐⭐⭐

7️⃣ 마무리

TDD를 도입하다가 포기하는 가장 큰 이유는 환경과 외부 의존성이다. Testcontainers는 이 문제를 거의 완벽하게 해결해 주지만
대신 버전 관리라는 새로운 책임을 요구한다. 잘 통제된 Testcontainers 환경은 테스트를 믿을 수 있게 만드는 마지막 퍼즐이라고 생각한다.