운영에서 조용히 문제를 일으킬 수 있는 지점들을 정리한다.
- env 검증(fail-fast): 설정이 잘못되면 서버가 뜨지 않는다.
운영에서 DB_* 누락과 'change-me' 같은 예시 값 배포를 차단하고,
문제를 하나씩이 아니라 한 번에 모아 보여준다.
DB_PASSWORD 가 없을 때 'password' 로 조용히 동작하던 폴백도 제거.
- graceful shutdown: SIGTERM 시 요청·커넥션을 정리한 뒤 종료한다.
종료 로그는 OnApplicationShutdown 훅으로 남긴다 —
process.on(signal) 로 직접 잡으면 Nest 의 종료 흐름에 간섭해 종료 코드가 달라진다.
- 헬스체크 두 가지 결함 수정:
pingCheck 기본 타임아웃 1초가 짧아 유휴 커넥션 재연결 시 정상 DB 를 down 으로 오판했고,
실패 응답이 SYS_001 로 덮여 어느 구성요소가 죽었는지 알 수 없었다.
모니터링이 읽는 엔드포인트이므로 표준 래퍼·에러 코드에서 제외한다.
- Rate limiting 을 @nestjs/throttler 로 일원화 (express-rate-limit 제거).
두 리미터가 겹쳐 헤더의 한도와 실제 동작이 어긋나 있었다.
- e2e 를 응답 계약 검증으로 교체. 기존 테스트는 없는 경로를 검사해 이미 실패 상태였다.
- 로깅 규칙(logging.md) 신설 — 레벨 기준·민감정보 마스킹·traceId
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ttipo
bf102d758f