TechFeedTechFeed
404클라이언트 오류(4xx)

404 Not Found — 리소스 없음

요청한 URL에 해당하는 리소스를 찾을 수 없다는 응답입니다. 경로 오타부터 삭제된 페이지, 라우팅 누락까지 원인이 다양합니다.

언제 발생하나

잘못된 URL, 동적 라우트의 미존재 파라미터(getStaticPaths 누락), 배포 누락, 대소문자 불일치에서 발생합니다.

실무 대응

  1. URL 경로·대소문자가 실제 라우트와 일치하는지 확인합니다.
  2. Next.js 동적 라우트는 getStaticPaths에 해당 경로가 포함됐는지, fallback 설정을 점검합니다.
  3. 배포 후 404면 빌드 산출물에 그 페이지가 생성됐는지(라우트 매핑) 확인합니다.
💡 실무 메모: 내부 링크가 404를 내면 크롤 예산·UX 손실입니다. 사이트맵의 URL과 실제 생성 경로가 일치하는지 정기 점검하세요(라우팅 매핑 버그 주의).

관련 코드·에러

관련 가이드

REST API 설계 체크리스트 2026 — 엔드포인트 네이밍부터 에러 응답까지 실무 35항목HTTP 404 에러 원인과 해결 방법 — 웹 개발 케이스별 정리