일반적인 오류 및 해결 방법 흐름
컴파일 및 런타임 오류
빌드 단계의 타입·모듈 오류와 실행 중 hydration·브라우저 API 접근 오류를 먼저 구분합니다.
서버 사이드 렌더링 (SSR) 및 데이터 페칭 오류
서버에서만 실행되는 데이터 요청인지, 브라우저와 공유되는 코드인지 구분해야 재현 위치를 좁힐 수 있습니다.
Vercel 배포 관련 오류
Vercel에 배포 시 발생하는 특유의 문제들입니다.
Next.js 애플리케이션을 개발하고 운영하다 보면 의존성 설치 실패, 포트 충돌, SSR 런타임 오류처럼 원인과 확인 위치가 다른 문제를 만납니다. 핵심은 증상별로 확인 순서를 잡아 빠르게 진단하는 데 있습니다.
npm 설치 문제, 포트 충돌, 환경 설정 오류를 증상별로 나누어 진단 기준을 정리합니다.
프로젝트를 시작하거나 의존성을 업데이트할 때 흔히 발생하는 오류들입니다.
빌드 단계의 타입·모듈 오류와 실행 중 hydration·브라우저 API 접근 오류를 먼저 구분합니다.
서버에서만 실행되는 데이터 요청인지, 브라우저와 공유되는 코드인지 구분해야 재현 위치를 좁힐 수 있습니다.
Vercel에 배포 시 발생하는 특유의 문제들입니다.