404 Not Found 원인 점검

Problem

특정 URL 또는 최종 도달 경로가 404 Not Found를 반환합니다.

Symptoms

• HTTP Check의 최종 응답 코드가 404입니다.
• 리다이렉트 후 최종 URL에서만 404가 발생합니다.
• 정적 자산 또는 특정 페이지 경로만 누락됩니다.

Top 3 Causes

1. 배포 누락 또는 경로 오타 - 실제 파일, 라우트, 리소스가 존재하지 않습니다.
2. rewrite 또는 리다이렉트 오류 - 정상 경로가 다른 비존재 경로로 이동됩니다.
3. 호스트 분기 문제 - 기대한 앱이 아닌 다른 origin 또는 환경으로 라우팅됩니다.

Diagnose with DechoNet

• HTTP Check로 최종 URL과 리다이렉트 경로를 추적합니다.
• DNS Lookup으로 도메인이 올바른 서비스 대상으로 향하는지 확인합니다.

Resolution Checklist

• 최종 404가 나는 경로가 실제 배포 산출물 또는 라우터 정의에 존재하는지 확인합니다.
• redirect 또는 rewrite 규칙이 정상 경로를 깨고 있지 않은지 점검합니다.
• www/non-www, 서브도메인, 언어 프리픽스 차이로 다른 경로로 들어가지 않는지 확인합니다.
• 배포 환경별 base path 또는 trailing slash 정책이 일치하는지 검토합니다.
• 수정 후 HTTP Check로 최종 도달 경로가 정상 응답인지 확인합니다.

When to Escalate

• 정적 사이트 빌드/배포 파이프라인에서 파일이 누락되면 배포 설정을 관리하는 팀과 같이 봐야 합니다.
• 라우터 또는 프레임워크 레벨 rewrite 규칙이 복잡하면 애플리케이션 담당자 검토가 필요합니다.