배포 전에 확인해야 할 스키마 변경사항

데이터베이스 배포는 신중해야 한다. 특히 스키마 변경은 한 번 잘못되면 롤백이 어렵거나 데이터 손실로 이어질 수 있다. 배포 전에 마이그레이션 상태를 정확히 파악하는 게 최우선이다.

정상 상태 정의

데이터 계층 문제를 풀 때는 정상 상태를 먼저 정해두는 게 좋다. 백업 여부, 마이그레이션 상태, 스키마 버전을 모두 확인해야 한다.

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

배포 전 검증

npx prisma validate
npx prisma migrate status

스키마를 바꾸기 전에 항상 prisma validate로 문법을 확인하고, migrate status로 현재 상태를 파악한다.

환경별 차이 관리

로컬과 운영 환경의 마이그레이션 상태가 다를 수 있다. 환경 차이까지 적어두면 원인 추적이 수월하다.

최종 점검

1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해본다.
3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

배포는 한 번에 여러 설정을 바꾸지 않는 것만으로도 원인 추적이 쉬워진다. 작은 기록을 남겨두면 다음 확인이 훨씬 빨라진다.