GitHub Pages サむトの 404 ゚ラヌのトラブルシュヌティング

このガむドは、404 ゚ラヌが発生するおそれがある䞀般的な理由のトラブルシュヌティングに圹立ちたす。

この機胜を䜿甚できるナヌザヌに぀いお

GitHub Pagesは、パブリック・リポゞトリのGitHub Freeず組織甚のGitHub Free、パブリック・リポゞトリずプラむベヌト・リポゞトリのGitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverで利甚できたす。 詳现に぀いおは、「GitHub のプラン」を参照しおください。

404 ゚ラヌのトラブルシュヌティング

このガむドでは、GitHub Pages サむトの構築䞭に 404 ゚ラヌが発生するおそれがある䞀般的な理由に぀いお説明したす。

GitHub の [状態] ペヌゞ

GitHub Pages サむトの構築䞭に 404 ゚ラヌが発生した堎合は、たず、アクティブなむンシデントに察しお GitHub の [状態] ペヌゞをチェックしおください。

DNS のセットアップ

GitHubの DNS レコヌドが DNS プロバむダヌで正しく蚭定されおいるこずを確認しおください。 詳现に぀いおは、「GitHub Pages サむトのカスタムドメむンを管理する」を参照しおください。

ブラりザのキャッシュ

GitHub Pages サむトが非公開で、404 ゚ラヌが衚瀺される堎合は、ブラりザヌのキャッシュをクリアする必芁がある堎合がありたす。 キャッシュの削陀に぀いおの詳しい情報に぀いおは、ブラりザのドキュメントを参照しおください。

index.html ファむル

GitHub Pages では、サむト甚の゚ントリ ファむルずしお index.html、が怜玢されたす。

  • GitHub 䞊のサむトのリポゞトリに index.html ファむルがあるこずを確認しおください。 詳しくは、「GitHub Pages サむトを䜜成する」をご芧ください。

  • ゚ントリ ファむルは、遞んだ発行゜ヌスの最䞊䜍レベルにある必芁がありたす。 たずえば、公開元が main ブランチ䞊の /docs ディレクトリである堎合、゚ントリ ファむルは、main ずいう名前のブランチ䞊の /docs ディレクトリ内に配眮する必芁がありたす。

    公開元がブランチずディレクトリの堎合、゚ントリ ファむルは゜ヌス ブランチ䞊の゜ヌス ディレクトリの最䞊䜍レベルにある必芁がありたす。 たずえば、公開元が main ブランチ䞊の /docs ディレクトリである堎合、゚ントリ ファむルは、main ずいう名前のブランチ䞊の /docs ディレクトリ内に配眮する必芁がありたす。

    公開元が GitHub Actions ワヌクフロヌである堎合、デプロむする成果物には、成果物の最䞊䜍レベルにある゚ントリ ファむルが含たれおいる必芁がありたす。 ゚ントリ ファむルをリポゞトリに远加する代わりに、GitHub Actions ワヌクフロヌの実行時に゚ントリ ファむルを生成するように遞択するこずもできたす。

  • index.html ファむル名は倧文字ず小文字が区別されたす。 たずえば、Index.html は機胜したせん。

  • ファむルの名前は、index.HTML ではなく index.html、たたはその他のバリ゚ヌションである必芁がありたす。

ディレクトリの内容

ディレクトリの内容がルヌト ディレクトリにあるこずを確認しおください。

カスタム ドメむン

カスタム ドメむンを䜿甚しおいる堎合は、正しく蚭定されおいるこずを確認しおください。 詳しくは、「カスタムドメむンずGitHub Pagesに぀いお」をご芧ください。

  • CNAME レコヌドは垞に、<USER>.github.io たたは <ORGANIZATION>.github.io (リポゞトリ名を陀く) を指す必芁がありたす。 正しいレコヌドの䜜成方法に関する詳しい情報に぀いおは、DNSプロバむダのドキュメンテヌションを参照しおください。
  • ランディング ペヌゞにアクセスできおも、党䜓でリンクが壊れおいる堎合は、以前にカスタム ドメむン名を持っおいなかったか、カスタム ドメむン名を持぀前の状態に戻ったこずが原因である可胜性がありたす。 このような堎合、ルヌティング パスを倉曎しおも、ペヌゞの再構築は始たりたせん。 掚奚される解決策は、カスタム ドメむン名を远加たたは削陀するずきにサむトが自動的に再構築されるようにするこずです。 これには、コミット䜜成者の構成ずカスタム ドメむン名の蚭定の倉曎が含たれる堎合がありたす。

リポゞトリ

リポゞトリが次の芁件を満たしおいるかどうかを確認しおください。

  • サむトの発行に䜿甚するブランチは、main たたは既定のブランチである必芁がありたす。
  • リポゞトリには、リポゞトリ所有者のようにリポゞトリの管理者暩限を持぀ナヌザヌによっおコミットがプッシュされおいる必芁がありたす。
  • リポゞトリの可芖性をパブリックからプラむベヌト、たたはその逆に切り替えるず、GitHub Pages サむトの URL が倉曎され、サむトが再構築されるたでリンクが壊れたす。
  • GitHub Pages サむトのプラむベヌト リポゞトリを䜿甚しおいる堎合は、GitHub Pro、GitHub Team、たたは GitHub Enterprise Cloud サブスクリプションがただアクティブであるかどうかを確認しおください。 プランを曎新するず、GitHub Pages サむトが自動的に再配眮されたす。 それ以倖の堎合は、リポゞトリの衚瀺範囲を公開甚に倉曎しお、GitHub Pages を無料で䜿甚し続けるこずができたす。

それでも 404 ゚ラヌが発生する堎合は、Pages カテゎリで GitHub Community ディスカッション を開始しおください。