404 오류 해결
이 가이드에서는 GitHub Pages 사이트를 빌드하는 동안 404 오류가 발생할 수 있는 일반적인 이유를 확인할 수 있습니다.
GitHub의 상태 페이지
GitHub Pages 사이트를 빌드하는 동안 404 오류가 표시되면 먼저 활성 인시던트에 대한 GitHub의 상태 페이지를 확인합니다.
브라우저 캐시
GitHub Pages 사이트가 비공개이고 404 오류가 표시되는 경우 브라우저의 캐시를 지워야 할 수 있습니다. 캐시 지우기에 관한 자세한 내용은 브라우저의 설명서를 참조하세요.
index.html 파일
GitHub Pages은(는) 사이트에 대한 항목 파일로 index.html 파일을 찾습니다.
-
GitHub Enterprise Server에 있는 사이트의 리포지토리에
index.html파일이 있는지 확인합니다. 자세한 내용은 "GitHub Pages 사이트 만들기"을(를) 참조하세요. -
항목 파일은 선택한 게시 원본의 최상위 수준에 있어야 합니다. 예를 들어 게시 원본이
main분기의/docs디렉터리인 경우, 항목 파일은main이라는 분기의/docs디렉터리에 있어야 합니다.게시 원본이 분기 및 디렉터리인 경우 항목 파일은 원본 분기의 소스 디렉터리 최상위 수준에 있어야 합니다. 예를 들어 게시 원본이
main분기의/docs디렉터리인 경우, 항목 파일은main이라는 분기의/docs디렉터리에 있어야 합니다.게시 원본이 GitHub Actions 워크플로인 경우 배포하는 아티팩트에 아티팩트 최상위 수준에 있는 항목 파일이 포함되어야 합니다. 항목 파일을 리포지토리에 추가하는 대신 워크플로가 실행되면 GitHub Actions 워크플로에서 항목 파일을 생성하도록 선택할 수 있습니다.
-
index.html파일 이름은 대/소문자를 구분합니다. 예를 들어Index.html은 작동하지 않습니다. -
파일의 이름은
index.HTML또는 다른 변형이 아닌index.html이어야 합니다.
디렉터리 콘텐츠
디렉터리 콘텐츠가 루트 디렉터리에 있는지 확인합니다.
리포지토리
리포지토리가 다음 요구 사항을 충족하는지 확인합니다.
- 사이트를 게시하는 데 사용하는 분기가
main또는 기본 분기입니다. - 리포지토리에 대한 관리자 권한이 있는 사용자(예: 리포지토리 소유자)가 리포지토리에 커밋을 푸시해야 합니다.
- 리포지토리의 표시 여부를 공개에서 비공개로 전환하거나 그 반대로 전환하면 GitHub Pages 사이트의 URL이 변경되므로 사이트가 다시 빌드될 때까지 링크가 끊어집니다.
여전히 404 오류가 발생하는 경우 Pages 범주에서 GitHub Community 토론을 시작하세요.