Prisma 타입 체크리스트: 배포 전에 확인할 것

운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. TypeScript 쪽 문제는 화면만 봐서는 절대 모른다. 타입 안정성 전체 흐름에서 원인을 좁혀야 한다.

문제의 경계 정하기

TypeScript 쪽 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

로컬과 운영 비교하기

선택적/null 값부터 확인하면 불필요한 수정을 줄일 수 있다. 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어든다.

• 먼저 볼 값: optional/null 정의
• 비교할 값: 정상일 때의 타입 상태
• 남겨둘 기록: 빌드 로그, 응답 코드, 수정한 설정

npm run build
npx tsc --noEmit

타입 가드 확인

타입 가드가 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다. 따라서 이를 명확히 하는 게 중요하다.

1. 증상이 같은 조건에서 다시 나는지 확인한다.
2. 빌드 로그에서 바뀐 부분을 정확히 설명한다.
3. 실제 빌드 결과와 공개 URL을 최종 확인한다.

결과가 바뀐 이유를 빌드 로그로 설명할 수 있으면 충분히 정리된 것이다. 관련 기록을 남겨두면 다음 확인이 훨씬 빨라진다.