정상 문서와 문제 문서를 짝지어 비교합니다
같은 템플릿에서 정상 작동하는 문서와 문제 URL을 하나씩 고릅니다. 최초 HTTP 코드, 원본 HTML의 제목과 본문, 브라우저에서 렌더링한 결과, 데이터 요청의 성공 여부를 함께 기록합니다. 공통 푸터와 메뉴에 텍스트가 많다는 이유로 본문이 충분하다고 판정하지 않습니다. 요청한 문서의 고유 내용이 main 영역에 존재하는지 확인합니다.
세 가지 원인을 나눠 봅니다
문서 데이터가 실제로 삭제됐는지, 데이터는 있지만 조회가 실패했는지, 자바스크립트 실행 뒤에만 본문이 생성되는지 구분합니다. 잘못된 slug가 들어와도 기본 템플릿을 200으로 출력하면 없는 문서와 정상 문서를 구별하기 어렵습니다. 반대로 일시적인 외부 API 장애를 영구 삭제로 처리하는 것도 피해야 하므로 오류의 성격과 복구 가능성을 먼저 확인합니다.
요청 의도에 맞춰 처리합니다
- 문서가 존재하면 데이터 연결과 렌더링을 수정해 핵심 답변을 실제 응답에 제공합니다.
- 문서를 영구 이동했다면 내용상 대응하는 새 문서로 연결합니다.
- 대체 없이 폐기했다면 없는 문서라는 사실에 맞는 서버 응답을 설계합니다.
- 사이트맵과 내부 링크에서 폐기·오류 URL이 정상 문서처럼 소개되는지 함께 정리합니다.
예시로 상품 설명 페이지의 데이터가 비어 있는데 제목만 상품 상세로 남는 경우, 제목에 상품명을 더하는 것으로 문제가 해결되지는 않습니다. 구매 조건이나 핵심 설명을 복원할 수 있는지 확인하고, 복원할 문서가 없다면 요청 상태를 정직하게 표현해야 합니다. 이 예시는 특정 고객 사이트의 장애 기록이 아닙니다.
완료를 판정할 증거
정상 문서에서는 원본 또는 지원되는 렌더링 결과에 고유 답변이 있어야 합니다. 존재하지 않는 slug, 삭제한 문서, 데이터 조회 실패를 각각 테스트하고 같은 200 템플릿으로 뭉개지지 않는지 확인합니다. 검색도구에서 문제 분류가 바뀌는 시점은 별도로 관찰합니다. 서버 수정 직후의 검증 결과와 검색엔진의 재처리 결과를 하나의 완료 시점으로 쓰지 않습니다.
자주 묻는 질문
- 본문이 짧으면 모두 soft 404인가요?
- 글자 수만으로 판정하지 않습니다. 방문자가 요청한 정보를 실제로 제공하는지, 페이지의 목적과 문맥이 무엇인지 확인합니다. 짧아도 완결된 안내와 내용이 없는 오류 템플릿은 구분해야 합니다.
- 삭제한 문서를 무조건 홈으로 보내도 되나요?
- 사용자의 질문에 대응하는 대체 문서가 있는지 먼저 판단합니다. 관계없는 홈 이동은 요청한 정보를 제공하지 못하므로 삭제·이동·보존 중 실제 상태에 맞는 처리를 선택합니다.
공식 참고자료와 작성 기준
공식 문서는 도구·검색 기능의 근거이며, 위의 점검 순서와 완료 기준은 현랩의 실무 설계 제안입니다. 예시를 실제 고객의 성과나 검색엔진의 보장으로 해석하지 않습니다.