GitHub Pagesが表示されない時の対処|障害・404・公開処理・独自ドメインの確認

GitHub Pagesが404になる、新しい内容に変わらない、独自ドメインだけ開かない場合は、Pagesの障害、公開処理、ファイルの配置、DNSを順番に確認します。サイトやリポジトリを削除して作り直す前に、直前まで動いていた設定を残してください。

【要点】公開元と配信先を分けて見る

• リポジトリの最新コミットと、実際に公開されたコミットを比較します。
• 公開元のブランチ・フォルダ、またはActionsの成果物を確認します。
• 独自ドメインと既定URLで症状を比べます。
• DNS、公開範囲、リポジトリ名を同時に変えないでください。

公式サービス障害モニターほかのサービスの障害・メンテナンス・復旧履歴を確認

GitHub Pagesの公式状態です。独自ドメインのDNS提供元や、追加したCDNの障害は別に確認が必要です。

404・更新されない・証明書エラーの違い

公開設定と成果物を確かめる

1. 正常だった最終コミット、変更した設定、現在のURLを記録します。
2. リポジトリのPages設定で、公開元のブランチ・フォルダまたはActionsが想定どおりかを確認します。
3. 公開処理のログを開き、成功したコミットと最新のコミットを照合します。
4. 出力されたサイトの入口に index.html があるか確認します。ファイル名の大文字小文字にも注意します。

ソースにHTMLがあっても、ビルド後の成果物に入っていなければ公開されません。リポジトリ直下ではなく、指定された公開元や成果物のルートを確認します。GitHub公式のPagesの404対処に沿って調べてください。

URLとキャッシュを比較する

同じURLを許可された別ブラウザで開き、古いキャッシュだけを見ていないかを確認します。ブラウザのURL欄で、末尾のパス、リポジトリ名、大文字小文字を比較します。ローカルで動く相対パスでも、公開先がサブディレクトリになると画像やリンクが切れる場合があります。

公開処理が待機している時は、GitHub Actions側の状態も確認します。ビルドが通っていないままブラウザを何度更新しても新しいページにはなりません。失敗理由を解消して一度公開し、配信される内容を確認します。

独自ドメインだけの問題

ドメイン管理画面で設定された値と、Pages側の登録内容を照合します。担当者がDNSを変更したばかりなら、その変更履歴と反映状況を確認します。値を何度も変えると、どの設定で改善したか分からなくなります。メールのMXレコードなど、Webと無関係な設定は触りません。

独自ドメインを外す、リポジトリを非公開から公開へ変えるといった操作は、情報公開やURLへの影響があります。接続テストのためだけに行わず、サイトの管理者が必要性を判断します。証明書エラーを読者に無視させる運用も避けてください。

トップは開くのに下層ページだけ404になる場合

問題のURLと、配信された成果物内のファイル名・配置を照合します。文字の大小、ディレクトリ名、リンクの指定先が一致しているかを確認してください。トップが表示できるのに一部のパスだけ失敗する現象は、Pages全体の停止だけでは説明できません。直近のビルドで出力先やリンクの基準を変えていないかを調べます。

独自ドメインだけが開かない場合は、設定変更前のDNS値と変更時刻を記録します。証明書やDNSの問題を確認せず、デプロイを繰り返しても改善しない場合があります。一方でビルド自体が未完了なら、DNSを変える段階ではありません。最後に公開成功したコミットと現在の成果物を特定し、配信・URL・ドメインのどこで食い違ったかを順に調べます。

復旧後の確認とまとめ

トップページだけでなく、主要な下層ページ、画像、リンク、HTTPSを確認します。外部サービスへのフォーム送信などがある場合は、その機能が別途動くかも確認します。GitHub Pagesの対処では、公開された成果物とURLを照合し、設定を一つずつ確認することが重要です。

国内の通信・アプリ・企業システム障害のまとめを見る