{"meta":{"title":"GitHub ページ サイトの 404 エラーのトラブルシューティング","intro":"このガイドは、404 エラーが発生するおそれがある一般的な理由のトラブルシューティングに役立ちます。","product":"GitHub Pages","breadcrumbs":[{"href":"/ja/pages","title":"GitHub Pages"},{"href":"/ja/pages/getting-started-with-github-pages","title":"概要"},{"href":"/ja/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites","title":"404 エラーをトラブルシューティングする"}],"documentType":"article"},"body":"# GitHub ページ サイトの 404 エラーのトラブルシューティング\n\nこのガイドは、404 エラーが発生するおそれがある一般的な理由のトラブルシューティングに役立ちます。\n\n## 404 エラーのトラブルシューティング\n\nこのガイドでは、GitHub Pages サイトの構築中に 404 エラーが発生するおそれがある一般的な理由について説明します。\n\n* ```\n            [GitHub の状態のページ](#githubs-status-page)\n  ```\n* [DNS セットアップ](#dns-setup)\n* [ブラウザのキャッシュ](#browser-cache)\n* [\n  `index.html` ファイル](#indexhtml-file)\n* [ディレクトリの内容](#directory-contents)\n* [カスタム ドメイン](#custom-domain)\n* [リポジトリ](#repository)\n\n### GitHub の \\[状態] ページ\n\nGitHub Pages サイトの構築中に 404 エラーが発生した場合は、まず、アクティブなインシデントに対して GitHub の [\\[状態\\] ページ](https://githubstatus.com)をチェックしてください。\n\n### DNS のセットアップ\n\nGitHubの DNS レコードが DNS プロバイダーで正しく設定されていることを確認してください。 詳細については、「[GitHub ページ サイトのカスタム ドメインの管理](/ja/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。\n\n### ブラウザのキャッシュ\n\nGitHub Pages サイトが非公開で、404 エラーが表示される場合は、ブラウザーのキャッシュをクリアする必要がある場合があります。 キャッシュの削除についての詳しい情報については、ブラウザのドキュメントを参照してください。\n\n### `index.html` ファイル\n\nGitHub Pages では、サイト用のエントリファイルとして `index.html` を検索します。\n\n* GitHub 上のサイトのリポジトリに `index.html` ファイルがあることを確認してください。 詳しくは、「[GitHub ページ サイトの作成](/ja/pages/getting-started-with-github-pages/creating-a-github-pages-site#creating-your-site)」をご覧ください。\n\n* エントリ ファイルは、選んだ発行ソースの最上位レベルにある必要があります。 たとえば、公開元が `/docs` ブランチ上の `main` ディレクトリである場合、エントリ ファイルは、`/docs` という名前のブランチ上の `main` ディレクトリ内に配置する必要があります。\n\n  公開元がブランチとディレクトリの場合、エントリ ファイルはソース ブランチ上のソース ディレクトリの最上位レベルにある必要があります。 たとえば、公開元が `/docs` ブランチ上の `main` ディレクトリである場合、エントリ ファイルは、`/docs` という名前のブランチ上の `main` ディレクトリ内に配置する必要があります。\n\n  公開元が GitHub Actions ワークフローである場合、デプロイする成果物には、成果物の最上位レベルにあるエントリ ファイルが含まれている必要があります。 エントリ ファイルをリポジトリに追加する代わりに、GitHub Actions ワークフローの実行時にエントリ ファイルを生成するように選択することもできます。\n\n* `index.html` ファイル名は大文字と小文字が区別されます。 たとえば、`Index.html` は機能しません。\n\n* ファイルの名前は、`index.html` ではなく `index.HTML`、またはその他のバリエーションである必要があります。\n\n### ディレクトリの内容\n\nディレクトリの内容がルート ディレクトリにあることを確認してください。\n\n### カスタム ドメイン\n\nカスタム ドメインを使用している場合は、正しく設定されていることを確認してください。 詳しくは、「[カスタム ドメインと GitHub ページについて](/ja/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages)」をご覧ください。\n\n* `CNAME` レコードは常に、`<USER>.github.io` または `<ORGANIZATION>.github.io` (リポジトリ名を除く) を指す必要があります。 正しいレコードの作成方法に関する詳しい情報については、DNSプロバイダのドキュメンテーションを参照してください。\n* ランディング ページにアクセスできても、全体でリンクが壊れている場合は、以前にカスタム ドメイン名を持っていなかったか、カスタム ドメイン名を持つ前の状態に戻ったことが原因である可能性があります。 このような場合、ルーティング パスを変更しても、ページの再構築は始まりません。 推奨される解決策は、カスタム ドメイン名を追加または削除するときにサイトが自動的に再構築されるようにすることです。 これには、コミット作成者の構成とカスタム ドメイン名の設定の変更が含まれる場合があります。\n\n### リポジトリ\n\nリポジトリが次の要件を満たしているかどうかを確認してください。\n\n* サイトの発行に使用するブランチは、`main` または既定のブランチである必要があります。\n* リポジトリには、リポジトリ所有者のようにリポジトリの管理者権限を持つユーザーによってコミットがプッシュされている必要があります。\n* リポジトリの可視性をパブリックからプライベート、またはその逆に切り替えると、GitHub Pages サイトの URL が変更され、サイトが再構築されるまでリンクが壊れます。\n* GitHub Pages サイトのプライベート リポジトリを使用している場合は、GitHub Pro、GitHub Team、または GitHub Enterprise Cloud サブスクリプションがまだアクティブであるかどうかを確認してください。 プランを更新すると、GitHub Pages サイトが自動的に再配置されます。 それ以外の場合は、リポジトリの表示範囲を公開用に変更して、GitHub Pages を無料で使用し続けることができます。\n\nそれでも 404 エラーが発生する場合は、Pages カテゴリで [GitHub Community ディスカッション](https://github.com/orgs/community/discussions/categories/pages) を開始してください。"}