---
kind: REFERENCE
slug: local-with-a-different-db-is-a-different-system
title: 로컬이 다른 DB면 로컬 테스트는 다른 시스템에 대한 진술이다
topic: schema-ownership-and-capability-streams
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: reference:local-with-a-different-db-is-a-different-system
verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
---

# 로컬이 다른 DB면 로컬 테스트는 다른 시스템에 대한 진술이다

## 목적

로컬에서 초록불이라는 사실을 배포 대상에 대한 증거로 읽는 것을 막는다.

## 규칙

1. 로컬 데이터베이스가 다르면 결과도 다른 시스템의 것이다
   방언과 타입 매핑과 제약 처리와 잠금 동작이 다르다.

2. 스키마를 엔티티에서 만드는 구성은 스키마 불일치를 원리적으로 발견하지 못한다
   생성 소스와 검증 소스가 같으면 어긋날 수 없다.

3. 실제 데이터베이스에 대한 레인을 별도로 둔다
   그 레인이 없으면 이 계열의 결함은 배포 시점에 처음 나타난다.

4. 로컬 설정이 값을 덮어쓰면 기본값의 결함이 로컬에서 보이지 않는다
   기본값을 검증하는 경로가 따로 필요하다.

5. 어느 결함이 어느 환경에서만 보이는지 기록한다
   그 정보가 다음 사람이 레인을 고를 때 쓰인다.

## 적용 조건

로컬과 배포 대상의 데이터베이스가 다른 모든 프로젝트

프로파일별로 설정 기본값이 덮이는 구성

## 예외

데이터베이스에 의존하지 않는 순수 로직 테스트는 이 규칙의 대상이 아니다.

## 예시

고정 길이와 가변 길이 컬럼 타입 불일치가 실제 PostgreSQL 검증에서 기동 실패를 냈고, 로컬이 H2 로 도는 동안에는 보이지 않았다. H2 구성은 엔티티에서 스키마를 만들므로 엔티티와 어긋날 수 없다.

풀 커넥션 타임아웃 기본값의 형식 오류가 prod 와 dev 배포를 전부 실패시켰고 로컬만 통과했다. 로컬 프로파일 파일이 그 값을 덮어쓴다.

## 관계

- **char(64)와 varchar(64) 불일치를 H2가 가리고 있었다**
  이 규칙을 만든 사례다.
- **connection-timeout이 5s 문자열로 출하되어 prod와 dev 배포가 전부 시작에 실패했다**
  네 번째 규칙의 사례다.
- **컨테이너가 필요한 특수 레인의 실제 결과를 실행으로 확인하지 않았다**
  실제 데이터베이스 레인의 현재 상태에 대한 질문이다.