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 が変更され、サイトが再構築されるまでリンクが壊れます。
それでも 404 エラーが発生する場合は、Pages カテゴリで GitHub Community ディスカッション を開始してください。