← 전체 글로 돌아가기

DB

배포 전에 Prisma 마이그레이션 상태 확인하기

배포 전 Prisma 마이그레이션이 제대로 적용됐는지 확인하지 않으면, 배포 후 데이터베이스 에러가 터진다. 안전한 확인 순서를 정리했다.

배포 전에 Prisma 마이그레이션을 확인하는 건 선택이 아니라 필수다. 로컬과 배포 환경의 스키마가 다르면 문제가 생긴다.

현재 목표 파악

배포 전에 먼저 뭘 확인할 건지 정하자.

  • 마이그레이션이 모두 적용됐나: pending migration이 남아 있지 않나
  • DATABASE_URL은 제대로 설정됐나: 배포 환경에서 올바른 DB를 가리키나
  • 스키마는 최신 상태인가: Prisma schema와 DB가 일치하나

Prisma 명령어로 상태 확인

npx prisma validate
npx prisma migrate status

마이그레이션 수정 순서

마이그레이션에 문제가 있으면 다음 순서로 진행한다.

  1. 현재 마이그레이션 상태를 정확히 파악한다
  2. 스키마를 수정하고 새 마이그레이션을 생성한다
  3. 테스트 환경에서 먼저 적용한 후 배포한다

다음 액션 기록하기

뭘 어떻게 고쳤는지 남겨 두자. 다음 배포 때 참고할 수 있다.