Prisma migration이 느려질 때

Prisma 작업하다 보면 마이그레이션 상태 조회가 느려질 수 있다. 화면 하나만 보면 놓치는 게 많다. 로그와 응답을 함께 봐야 한다.

데이터 계층 문제는 한 단어만 붙잡지 말고 전체 흐름에서 원인을 좁혀야 한다. 재현 조건을 먼저 정하고, 하나씩 검토해가야 한다.

핵심 질문

Prisma 문제가 반복된다면 확인 순서를 고정하자. 감으로 접근하면 같은 실수를 반복한다.

제외할 원인들

Prisma 문제가 반복된다면 먼저 제외할 원인들을 생각해본다. DATABASE_URL이 맞는지 먼저 확인하자.

• 먼저 볼 것: DATABASE_URL
• 비교할 값: 정상일 때의 DB 상태
• 남길 기록: 명령어 출력, 오류 메시지, 수정한 설정

스키마 확인

데이터 계층 작업은 로컬과 운영의 차이가 자주 숨어 있다. 환경 차이까지 같이 적어두면 원인 추적이 쉬워진다.

npx prisma validate
npx prisma migrate status

실제 확인 순서를 정하고 매번 따라야 한다.

정상 상태 정의

정상 상태를 먼저 정해두면 결과가 맞는지 아닌지 빠르게 판단할 수 있다.

백업과 복구 계획

정상 상태를 먼저 정해두면 비정상일 때를 빠르게 알아차릴 수 있다. 권한을 확인하면 다음으로 볼 범위가 확 줄어든다.

확인 순서:

1. 같은 조건에서 증상이 다시 나오는지 확인한다
2. 로그나 응답에서 달라진 부분을 설명한다
3. 공개 화면, 빌드 결과, 실제 요청으로 확인한다

마무리

다음에 비슷한 증상이 나오면 먼저 현재 값을 기록하고, 하나씩 비교하면 된다. 관련 기록을 남겨두면 다음 확인이 훨씬 빨라진다.