404 Not Found

404 Not Found는 서버가 요청한 대상의 현재 표현을 찾지 못했거나 그 존재를 공개하지 않음을 알리는 HTTP 상태 코드입니다. 웹페이지 주소뿐 아니라 API의 개별 리소스를 요청할 때도 나타납니다. 영구 삭제 여부는 별도 확인 대상이며, 요청 주소와 서버의 경로·권한 처리, 실제 데이터 존재 여부를 함께 확인합니다.

요청한 대상에 대한 응답

HTTP 의미 명세 RFC 9110은 404를 대상 리소스의 현재 표현을 찾지 못했거나 존재를 밝히려 하지 않는 응답으로 정의합니다. 브라우저가 서버에 연결조차 못한 상황과 달리 HTTP 응답을 받은 상태입니다. 주소에 맞는 페이지가 없을 때 익숙하게 보이지만, 애플리케이션이 어떤 조건에서 이 코드를 반환하는지도 해석에 영향을 줍니다.

상품 상세 API에서 잘못된 상품 번호를 요청하면 개별 상품에 대한 404를 받을 수 있습니다. 같은 서버의 상품 목록은 정상으로 열릴 수 있으므로 한 요청의 404를 사이트 전체 장애로 확대하지 않습니다. 요청 메서드와 전체 경로, 전달한 식별자, 대상 환경을 함께 보면 어느 계층에서 대상을 찾지 못했는지 좁힐 수 있습니다. 이 사례는 상태 코드의 범위를 설명하는 예시입니다.

라우트가 등록되지 않은 경우와 라우트는 있지만 조회한 데이터가 없는 경우도 구별합니다. 앞쪽은 요청을 처리할 코드까지 도달하지 못한 상황이고, 뒤쪽은 처리 코드가 리소스 부재를 판단한 상황입니다. 화면에 같은 안내가 나와도 수정할 위치가 다릅니다. 프록시나 배포 설정이 먼저 반환한 응답일 수도 있으므로 실제로 응답을 만든 서버와 기록을 연결합니다.

일시적 부재와 영구 삭제의 차이

MDN의 404 설명은 404 자체가 부재의 일시성이나 영구성을 알려 주지 않는다고 설명합니다. 영구적으로 제거됐음을 알리는 상태에는 410 Gone이 있습니다. 코드 하나만 보고 다시는 복구되지 않을 페이지라고 단정하기보다, 서버가 어떤 의미로 응답하는지와 실제 콘텐츠 상태를 확인하는 이유입니다.

같은 MDN 문서는 주소 오타와 리디렉션 없이 이동하거나 삭제한 페이지를 흔한 원인으로 제시합니다. 문서가 다른 주소로 옮겨졌다면 이전 링크와 새 주소의 관계를 다룰 수 있습니다. 대상이 없는데 모든 주소를 홈페이지로 보내는 처리는 원래 정보를 찾는 문제를 해결하지 못할 수 있습니다. 이동과 삭제 중 어느 경우인지 먼저 구분하면 안내와 경로 처리의 목적이 분명해집니다.

권한이 없는 대상의 존재를 감추기 위해 404를 사용하는 서버도 있습니다. RFC 9110은 금지된 대상의 존재를 숨기고 싶은 서버가 403 대신 404로 응답할 수 있도록 합니다. 로그인 계정에 따라 같은 주소의 결과가 달라진다면 권한 조건도 확인 대상입니다. 404라는 숫자만으로 인증이나 인가와 무관하다고 판단하지 않습니다.

오류 화면과 상태 코드의 일치

오류 안내 화면의 문구와 HTTP 상태는 별도로 확인할 수 있습니다. ‘페이지를 찾을 수 없습니다’라는 글자를 보여 주면서 200 성공 상태를 보내면, 사람이 보는 내용과 프로그램이 읽는 응답 의미가 달라집니다. API에서는 본문에 오류 메시지가 있다는 사실과 적절한 상태 코드를 받은 사실을 나눕니다. SDK가 오류를 어떻게 전달하는지도 실제 응답 계약에서 확인합니다.

RFC 9110의 404 정의는 다른 캐시 제어가 없는 경우 404가 휴리스틱 캐시 대상이 될 수 있다고 설명합니다. 경로나 데이터를 고친 뒤에도 이전 응답을 보는 상황에서는 응답 헤더와 중간 캐시를 함께 살펴볼 수 있습니다. 다만 모든 404가 같은 기간 동안 저장되는 것은 아닙니다. 캐시 정책과 실제 응답을 확인하지 않고 고정된 대기 시간을 안내하지 않습니다.

복구 확인은 원래 실패한 URL과 메서드로 다시 요청하고 의도한 내용을 받는지 대조하는 방식으로 진행합니다. 배포 성공 표시나 관리 화면의 데이터 존재만으로 공개 경로가 복구됐다고 보지 않습니다. 삭제한 콘텐츠라면 남은 내부 링크와 이용자 안내도 검토 대상입니다. 외부 검색에서 해당 주소가 사라지거나 새 주소로 바뀌는 시점은 서버 응답 확인과 별도로 관측합니다.