DEV WIKI
인프라 · 오류·증상

HTTP 404 - File not found

IIS의 `HTTP 404 - File not found` 화면과 로그를 기준으로 요청 파일, 가상 디렉터리, 404 하위 상태, MIME 매핑과 요청 필터링을 구분해 확인합니다.

빠른 답변

우선 확인할 원인
IIS의 HTTP 404 - File not found는 서버가 요청한 페이지를 가져오지 못했다는 뜻입니다. 요청 URL의 파일 위치와 이름, 가상 디렉터리 매핑을 먼저 확인하고 IIS 로그가 404.2이면 웹 확장, 404.3이면 MIME 매핑, Request Filtering 모듈이 표시되면 필터 규칙을 각각 확인해야 합니다.
먼저 확인할 항목
브라우저의 전체 URL과 `HTTP 404 - File not found` 문구, IIS 로그의 `sc-status`, `sc-substatus`, 모듈을 함께 기록합니다. 기대 결과는 일반 404, 404.2, 404.3, 요청 필터링 문제를 구분할 수 있는 것입니다.
적용 범위
현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
출처 확인일
2026-08-29
최종 검토
2026-08-29
수정일
2026-08-29
관련 기술
오류·수정 제보 (새 창에서 열림)

현재 증상

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

먼저 확인할 항목

브라우저의 전체 URL과 `HTTP 404 - File not found` 문구, IIS 로그의 `sc-status`, `sc-substatus`, 모듈을 함께 기록합니다. 기대 결과는 일반 404, 404.2, 404.3, 요청 필터링 문제를 구분할 수 있는 것입니다.

IIS Manager에서 요청 URL이 연결되는 실제 파일 경로를 확인하고 파일의 존재 여부, 위치와 이름 철자를 비교합니다. 기대 결과는 요청 URL과 실제 파일이 일치하는 것입니다.

요청 경로가 가상 디렉터리라면 실제 드라이브의 하위 폴더와 올바른 파일을 가리키는지 확인합니다. 기대 결과는 가상 디렉터리의 물리 경로에서 요청 파일을 찾을 수 있는 것입니다.

IIS 로그가 404.2이면 필요한 웹 서비스 확장 사용 여부를, 404.3이면 요청 파일 확장자의 MIME 매핑을 확인합니다. 기대 결과는 로그 하위 상태와 변경 대상이 일치하는 것입니다.

오류 화면이나 Failed Request Tracing에 Request Filtering 모듈이 표시되면 차단 규칙과 숨김 파일 설정을 확인합니다. 기대 결과는 요청한 경로가 실제 필터 규칙에 의해 차단됐는지 판별하는 것입니다.

수정 후 같은 URL과 요청 방식으로 다시 요청하고 IIS 로그의 상태·하위 상태를 확인합니다. 기대 결과는 정상 응답이 반환되고 같은 404 하위 상태가 반복되지 않는 것입니다.

피해야 할 조치

주의

  • IIS 로그의 하위 상태와 모듈을 확인하지 않은 채 웹 서비스 확장, MIME 형식 또는 요청 필터 규칙을 모두 허용하지 않습니다.
  • 파일을 새 위치로 복사하거나 가상 디렉터리 매핑을 바꾸기 전에 현재 사이트 경로와 IIS 설정을 기록해 되돌릴 수 있게 합니다.
  • 404 응답만 보고 파일이 없다고 단정하지 않습니다. IIS는 비활성 웹 확장, MIME 매핑과 요청 필터링 문제에도 404 하위 상태를 기록할 수 있습니다.

환경별 원인과 조치

IIS에서 페이지를 요청할 때 브라우저에 HTTP 404 - File not found 또는 404 - File or directory not found가 표시될 수 있습니다. 이 응답은 서버가 요청한 페이지를 가져오지 못했다는 결과이며, 파일 누락만으로 원인을 확정할 수 없습니다.

먼저 기록할 값

  1. 오류가 발생한 전체 URL과 요청 방식을 기록합니다.
  2. IIS W3C 로그의 sc-status, sc-substatus, sc-win32-status를 기록합니다.
  3. Detailed Error 또는 Failed Request Tracing에 표시된 모듈과 Handler를 기록합니다.
  4. 최근 파일 배포, 가상 디렉터리, MIME 형식과 Request Filtering 변경을 기록합니다.

로그 값에 따라 확인

관찰값확인할 대상다음 문서
일반 404 또는 파일을 찾을 수 없다는 화면요청 URL의 파일 위치·이름, 배포 결과, 가상 디렉터리 물리 경로이 문서에서 계속 확인
IIS 로그 404.2필요한 웹 서비스 확장이 사용 상태인지 확인IIS 404.2
IIS 로그 404.3요청 파일 확장자의 MIME 매핑 확인IIS 404.3
Request Filtering 모듈 또는 숨김 파일 관련 상세 오류차단 규칙·숨김 세그먼트·숨김 정적 파일 설정현재 규칙과 요청 경로를 비교

파일과 가상 디렉터리 확인

  1. IIS Manager에서 요청한 사이트와 애플리케이션의 물리 경로를 확인합니다.
  2. 브라우저 URL의 상대 경로를 물리 경로에 적용해 요청 파일이 실제로 존재하는지 확인합니다.
  3. 파일 이름의 철자와 확장자가 요청 URL과 일치하는지 확인합니다.
  4. 요청 경로가 가상 디렉터리라면 설정된 물리 경로가 드라이브의 루트가 아닌 올바른 하위 폴더를 가리키는지 확인합니다.
  5. 배포 과정에서 파일이 이름 변경·이동·삭제되지 않았는지 배포 산출물과 서버 파일을 비교합니다.

가상 디렉터리는 웹 사이트의 홈 디렉터리에는 없지만 클라이언트 브라우저에는 홈 디렉터리에 있는 것처럼 보이는 디렉터리입니다.

수정 후 확인

  1. 같은 URL과 요청 방식으로 다시 요청합니다.
  2. 브라우저 응답과 IIS 로그의 상태·하위 상태가 정상으로 바뀌었는지 확인합니다.
  3. 직접 파일 URL뿐 아니라 해당 파일을 사용하는 실제 화면에서도 자산과 기능이 정상인지 확인합니다.

로그의 하위 상태나 모듈을 확인하지 않은 상태에서 MIME 형식이나 웹 확장, 요청 필터 규칙을 모두 허용하지 않습니다. 변경 전 설정을 기록하고 필요한 항목만 수정합니다.

출처: Microsoft Learn: Troubleshoot HTTP 404 File Not Found in IIS (새 창에서 열림)

참고 자료

Troubleshoot HTTP 404 File Not Found in IIS - Internet Information Services | Microsoft Learn (새 창에서 열림)

Microsoft Learn · 공식 자료 · 확인 범위: IIS는 요청한 페이지를 검색할 수 없을 때 "HTTP 404 - File not found" 오류 메시지를 반환합니다., 요청 파일의 이름 변경·이동·삭제, 비활성 웹 서비스 확장, 등록되지 않은 MIME 형식과 가상 디렉터리 매핑은 원문이 제시한 확인 대상입니다., IIS MMC 스냅인에서 가상 디렉터리의 실제 경로와 요청 파일 위치·이름을 확인할 수 있습니다., IIS 로그의 404.2는 웹 확장, 404.3은 MIME 매핑을 확인하는 구분 기준이며 Request Filtering과 숨김 정적 파일도 관련 원인일 수 있습니다. · 확인일: 2026-08-29