데이터베이스와 상호작용하는 코드는 어떻게 테스트하나요?

Question

Accepted Answer

**데이터베이스**를 사용하는 코드를 테스트하는 것은 까다롭습니다 — 불안정성이나 느림 없이 현실적인 데이터 동작이 필요합니다. 접근법으로는 **테스트 데이터베이스**, **인메모리 데이터베이스**, **트랜잭션/롤백**, **데이터 계층 mocking**이 있으며, 각각 트레이드오프가 있습니다.

## 과제

```text
데이터베이스와 상호작용하는 코드는 테스트가 필요하지만, 데이터베이스는 과제를 가져온다:
  → 실제 DB → 현실적이지만 더 느림; 셋업과 정리 필요 (테스트 간 상태)
  → 공유 상태 → 테스트가 서로 간섭 가능 (순서 의존, 불안정성)
  → DB mocking → 빠르지만 실제 쿼리/통합 버그를 못 잡을 수 있음
→ 현실성, 속도, 격리의 균형을 맞추는 접근법을 선택하라.
```

## 접근법

```text
1. 실제 테스트 데이터베이스 → 테스트용 전용 DB (운영과 같은 엔진):
   ✓ 현실적 (실제 쿼리/스키마 문제 포착)  ✗ 더 느림; 정리/격리 필요
   → 깨끗하고 일관된 DB를 테스트 실행마다 위해 흔히 컨테이너(Docker)에서 실행
2. 트랜잭션 롤백 → 각 테스트를 트랜잭션으로 감싸고 이후 롤백 → 깨끗한 상태,
   남은 데이터 없음, 데이터 재생성보다 빠름 (흔한 패턴)
3. 인메모리 데이터베이스 (예: 메모리 내 SQLite) → 빠르고 설정 쉬움  ✗ 운영
   DB와 다를 수 있음 (다른 SQL/기능 → 운영 특유 문제를 놓칠 수 있음)
4. 데이터 계층 mock → 빠르고 격리된 단위 테스트  ✗ 실제 DB 동작을 테스트 안 함
   (단위 테스트에 사용; integration test에는 실제 DB 사용)
```

## 모범 사례

```text
✓ 테스트 격리 — 각자 알려진 깨끗한 상태에서 시작 (트랜잭션, truncate, 새 DB)
✓ 현실적인 테스트 데이터 사용 (fixture/factory/seed)
✓ 데이터 계층은 실제 DB 동작 테스트(integration); 그 위 비즈니스 로직을
  단위 테스트할 때는 DB를 mock
✓ DB 테스트를 합리적으로 빠르게 유지; CI에서 깨끗한 DB 실행 (컨테이너)
```

## 왜 중요한가

데이터베이스와 상호작용하는 코드를 테스트하는 방법을 이해하는 것은 가치가 있습니다. **대부분의 애플리케이션이 데이터베이스를 사용**하며, 데이터 액세스를 올바르게 테스트하는 것이 중요하면서도 까다로우므로 유용한 실용 지식입니다.

데이터베이스 코드(쿼리, 데이터 액세스, 영속성)는 테스트가 필요하지만, 데이터베이스는 실제 과제를 도입합니다 — 더 느리고, 셋업과 정리가 필요하고, 테스트 간섭과 불안정성을 일으킬 수 있는 공유 상태를 가지며, mocking은 실제 쿼리 버그를 놓칠 수 있습니다.

**접근법과 그 트레이드오프**를 이해하는 것이 핵심 지식입니다: **실제 테스트 데이터베이스**(현실적이며 실제 쿼리와 스키마 문제를 포착, 일관성을 위해 흔히 컨테이너에서 실행, 그러나 더 느리고 격리 필요), **트랜잭션 롤백**(각 테스트를 트랜잭션으로 감싸고 롤백하여 깨끗한 상태 — 테스트를 격리하고 합리적으로 빠르게 유지하는 흔하고 효과적인 패턴), **인메모리 데이터베이스**(빠르고 쉽지만 운영과 다를 수 있어 운영 특유 문제를 놓칠 위험), **데이터 계층 mocking**(빠르고 격리된 단위 테스트지만 실제 데이터베이스 동작을 테스트하지 않음).

각각을 언제 사용할지 — 데이터 계층을 integration 테스트할 때는 실제 데이터베이스(실제 쿼리/스키마 버그 포착), 그 위 비즈니스 로직을 단위 테스트할 때는 mocking — 이해하는 것은 현실성, 속도, 격리의 균형에 대한 건전한 판단을 반영합니다.

**모범 사례** — **테스트 격리**(간섭과 불안정성을 피하기 위해 각자 트랜잭션, truncation, 새 데이터베이스를 통해 알려진 깨끗한 상태에서 시작), 현실적인 테스트 데이터 사용(fixture/factory), 데이터 계층의 실제 데이터베이스 동작 테스트, CI에서 깨끗한 데이터베이스 실행 — 을 이해하는 것은 효과적인 데이터베이스 테스팅을 반영합니다.

대부분의 애플리케이션이 데이터베이스를 사용하고 데이터 액세스를 올바르게 테스트하는 것(테스트를 격리되고 빠르고 신뢰할 수 있게 유지하면서 쿼리 버그를 포착)이 중요하지만 까다롭고, 접근법(실제 DB, 트랜잭션, 인메모리, mocking), 그 트레이드오프, 모범 사례(격리, 현실적 데이터)를 이해하는 것이 효과적인 데이터베이스 테스팅을 가능하게 하므로, 데이터베이스와 상호작용하는 코드를 테스트하는 방법을 이해하는 것은 가치 있고 실용적인 지식입니다. 이는 데이터 액세스를 신뢰성 있게 테스트하는 흔한 필요에 중요하며, 현실성을 속도 및 격리와 균형 잡는, 표준이 된 데이터 주도 애플리케이션을 테스트하는 유용한 기술입니다.