GitHub ページサイトの 404 エラーのトラブルシューティング

404 エラーのトラブルシューティング

このガイドでは、GitHub Pages サイトの構築中に 404 エラーが発生するおそれがある一般的な理由について説明します。

          [GitHub の状態のページ](#githubs-status-page)

        [ブラウザのキャッシュ](#browser-cache)

        [
        `index.html` ファイル](#indexhtml-file)

        [ディレクトリの内容](#directory-contents)

GitHub Pages サイトの構築中に 404 エラーが発生した場合は、まず、アクティブなインシデントに対して GitHub の [状態] ページをチェックしてください。

GitHub Pages サイトが非公開で、404 エラーが表示される場合は、ブラウザーのキャッシュをクリアする必要がある場合があります。キャッシュの削除についての詳しい情報については、ブラウザのドキュメントを参照してください。

          `index.html` ファイル

GitHub Pages では、サイト用のエントリファイルとして index.html を検索します。

GitHub 上のサイトのリポジトリに index.html ファイルがあることを確認してください。詳しくは、「GitHub ページサイトの作成」をご覧ください。
エントリファイルは、選んだ発行ソースの最上位レベルにある必要があります。たとえば、公開元が /docs ブランチ上の main ディレクトリである場合、エントリファイルは、/docs という名前のブランチ上の main ディレクトリ内に配置する必要があります。

公開元がブランチとディレクトリの場合、エントリファイルはソースブランチ上のソースディレクトリの最上位レベルにある必要があります。たとえば、公開元が /docs ブランチ上の main ディレクトリである場合、エントリファイルは、/docs という名前のブランチ上の main ディレクトリ内に配置する必要があります。

公開元が GitHub Actions ワークフローである場合、デプロイする成果物には、成果物の最上位レベルにあるエントリファイルが含まれている必要があります。エントリファイルをリポジトリに追加する代わりに、GitHub Actions ワークフローの実行時にエントリファイルを生成するように選択することもできます。

        `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 ディスカッションを開始してください。