Next.js 문제는 브라우저 패널과 서버 로그를 함께 연결해야 원인이 보인다
브라우저에서 보이는 현상이 항상 브라우저 문제는 아니다. 클라이언트, 서버, 저장소, 배포 로그를 분리해 본다.
| 상황 | 브라우저 패널 | 함께 볼 로그 | 수정 위치 |
|---|---|---|---|
| 클라이언트 컴포넌트 예외 | Console, Sources | 브라우저 stack trace | use client 컴포넌트, hook |
| API 응답 실패 | Network | terminal, Vercel Functions logs | route handler, server action |
| 인증 상태 꼬임 | Application, Network | auth callback, Proxy log | cookie, session, provider 설정 |
| 이미지/폰트 지연 | Network, Performance | Lighthouse/Web Vitals | next/image, next/font, cache header |
| 배포에서만 실패 | Console, Network | Vercel build/runtime logs | env, 대소문자, Node version |