배포 후 DB가 응답 안 할 때 확인 방법

로컬에서 개발할 땐 DB가 잘 작동했는데, 배포하니 안 된다. 이런 경우 가장 흔한 원인은 환경 차이다. 미들웨어부터 마이그레이션까지 데이터 계층 전체를 살펴봐야 한다.

문제를 크게 보지 말기

DB 문제는 크게 잡으면 모든 부분이 의심스러워진다. 그래서 차라리 작은 확인부터 시작하는 게 낫다. 마이그레이션부터 확인하면 불필요한 수정을 많이 줄일 수 있다.

DB 관점에서 볼 것들

DB 쪽 문제는 화면만 봐서는 절대 알 수 없다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

• 먼저 볼 값: 스키마와 마이그레이션 상태
• 비교할 값: 정상일 때의 데이터 계층
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

npx prisma validate
npx prisma migrate status

백업이 중요한 이유

배포 자체보다 재현 가능한 증거를 남기는 게 중요하다. 문제를 재현할 수 있으면, 다음으로 봐야 할 범위가 확 줄어든다.

1. 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그에서 바뀐 부분을 한 줄로 설명해본다.
3. 빌드 결과나 실제 데이터 조회로 최종 확인한다.

이 방법을 매번 반복하면 데이터 계층 문제는 빨리 해결된다.