DEV WIKI
백엔드 · 문제 해결 가이드

특정 URL만 404 Not Found가 보여요

특정 URL만 404를 반환할 때 배포 파일·라우팅·웹 서버 매핑·캐시 응답을 구분하고 다음 Problem을 고르는 가이드입니다.

빠른 답변

특정 URL만 404이면 URL 오타로 단정하지 말고 실제 HTTP 응답, 배포된 경로, 라우팅 규칙, 웹 서버 매핑을 순서대로 확인해야 합니다. 화면 문구와 HTTP 상태가 다르면 별도 문서로 이동합니다.

적용 범위
이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
출처
IETF
출처 확인일
2026-07-29
최종 검토
2026-08-05
수정일
2026-08-05
대상
사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
오류·수정 제보 (새 창에서 열림)

이 가이드가 맞는 경우

  • 애플리케이션 오류 메시지

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • 요청 URL, HTTP 메서드, 응답 상태와 발생 시각을 전달합니다.
  • 응답 본문이나 응답 헤더에 오류 식별자가 있으면 민감한 값 없이 전달합니다.
  • 인증 토큰, 세션 쿠키, 개인정보, 결제 정보는 전달하지 않습니다.

알아둘 점

404 Not Found는 서버가 요청한 리소스의 현재 표현을 찾지 못했거나 존재 여부를 공개하지 않는 상태입니다. 특정 URL만 404이면 주소 오타, 배포 누락, 라우팅, 웹 서버 매핑, 캐시 응답을 구분해 확인합니다.

먼저 기록할 것

  1. 요청 URL·HTTP 메서드·응답 상태·발생 시각을 기록합니다.
  2. 응답의 Server, Location, 캐시 헤더와 오류 식별자를 민감한 값 없이 기록합니다.
  3. 동일 경로의 대소문자·후행 슬래시·쿼리 문자열 차이를 비교합니다.
  4. 최근 배포·라우팅·웹 서버 가상 경로·CMS 고정주소 변경 여부를 기록합니다.

상황별 다음 단계

관찰값다음 문서
실제 HTTP 응답이 404 Not FoundHTTP 404: Not Found
화면 문구와 실제 HTTP 상태가 다르거나 응답을 확인하지 못함화면 오류 문구와 실제 HTTP 응답 상태가 일치하지 않음

상태 코드가 같아도 원인은 웹 서버, 프록시, 애플리케이션, 배포 파일, 라우팅마다 다를 수 있습니다. 이 가이드는 존재하지 않는 파일을 임의로 만들거나 데이터를 수정하도록 안내하지 않습니다.

수정 후 재확인

  1. 동일 URL을 원래 메서드와 GET으로 각각 요청해 상태와 응답 본문을 비교합니다.
  2. 배포된 파일·라우팅·웹 서버 매핑이 의도한 경로를 가리키는지 확인합니다.
  3. 정상 응답 후 관련 링크·새로고침·캐시 경로에서도 같은 URL이 정상인지 확인합니다.

같은 상황의 가이드

참고 자료

RFC 9110 - HTTP Semantics (새 창에서 열림)

IETF · 공식 자료 · 확인 범위: HTTP 404는 서버가 대상 리소스의 현재 표현을 찾지 못했거나 존재 여부를 공개하지 않는 상태를 나타냅니다. · 확인일: 2026-07-29