TypeScript에서 Prisma 타입을 다룰 때 실수하기 쉬운 부분

TypeScript와 Prisma를 함께 쓸 때, 타입이 일치하지 않으면 런타임에 예기치 않은 에러가 생긴다.

핵심 질문

Prisma 타입 문제가 터졌을 때는 먼저 이것들을 확인한다.

• 타입 가드가 제대로 돼 있나: optional과 null을 제대로 처리했나
• 실제 응답이 뭔가: 선언한 타입과 실제 API 응답이 일치하나
• 빌드 에러는 없나: TypeScript 컴파일이 정상인가

타입 체크

npm run build
npx tsc --noEmit

타입 안정성 확보하기

타입 문제를 미리 방지하려면 다음을 확인한다.

• optional과 null: 필수 필드와 선택 필드를 명확히
• 타입 가드: 런타임에 타입을 검증하는 로직
• API 응답 타입: 서버에서 오는 데이터가 정말 그 타입인가

검증 과정

1. 타입 에러를 정확히 파악한다
2. 선언한 타입과 실제 데이터가 일치하는지 확인한다
3. 빌드와 런타임에서 모두 제대로 작동하는지 본다

마무리

배포 전에 타입 체크를 반드시 실행하자. 실제 화면과 공개 URL까지 확인해야 작업이 끝난다.