GitHub 페이지 사이트에 대한 404 오류 문제 해결

404 오류 해결

이 가이드에서는 GitHub Pages 사이트를 빌드하는 동안 404 오류가 발생할 수 있는 일반적인 이유를 확인할 수 있습니다.

GitHub Pages 사이트를 빌드하는 동안 404 오류가 표시되면 먼저 활성 인시던트에 대한 GitHub의 상태 페이지를 확인합니다.

GitHub Pages 사이트가 비공개이고 404 오류가 표시되는 경우 브라우저의 캐시를 지워야 할 수 있습니다. 캐시 지우기에 관한 자세한 내용은 브라우저의 설명서를 참조하세요.

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이 변경되므로 사이트가 다시 빌드될 때까지 링크가 끊어집니다.
GitHub Pages 사이트에 프라이빗 리포지토리를 사용하는 경우 GitHub Pro, GitHub Team, GitHub Enterprise Cloud 구독이 여전히 활성 상태인지 확인하세요. 플랜을 갱신하면 GitHub Pages 사이트가 자동으로 다시 배포됩니다. 갱신하지 않을 시 리포지토리의 표시 유형을 공용으로 변경하여 GitHub Pages을(를) 무료로 계속 사용할 수 있습니다.

여전히 404 오류가 발생하는 경우 Pages 범주에서 GitHub Community 토론을 시작하세요.