予約公開のログには成功が残っていました。ところが数日後に記事のURLを確認すると、出てきたのは記事ではなくサイトのトップページでした。HTTPステータスは200。エラーページにも見えません。
2026年10月、anikuma.appで起きた公開欠落の記録です。原因は予約日時ではなく、その後の手動更新でした。予約処理が追加した記事を、別の配布経路が引き継いでいなかったのです。
復旧では、消えた2記事を戻すだけでなく、公開原本と公開履歴を配布前に照合する検査を追加しました。静的サイトに予約公開と手動更新を併設するとき、何を同じ基準にそろえる必要があるかを整理します。
最初の公開は、実際に成功していた
対象の2記事は10月16日と19日に公開されていました。予約処理は配布後に記事本文、一覧、サイトマップ、表紙、公開を識別するJSONを確認し、検証成功時刻を記録していました。当時の配布物にも記事が入っています。
一方、10月23日の確認時点では、ローカルの公開原本には57記事あるのに、本番のサイトマップには新しい2記事がありませんでした。記事のURLから返るHTMLにも本文がなく、canonicalはトップページを示していました。
「原本へ追加しただけで、最初から公開できていなかった」のか、「公開後に別の版へ置き換わった」のかでは、調べる場所が違います。今回、過去の成功時刻と固定した配布物が残っていたことで、後者として調査を進められました。
二つの配布経路が、別の原本を見ていた
予約公開は、確認済みの公開原本に1記事ずつ追加する処理でした。ところが、その後に書籍案内を直した手動更新では、Gitに保存されていた55記事の版から配布物を作っていました。予約処理が増やした2記事は、まだその版に含まれていませんでした。
手動更新の目的は書籍の案内文を直すことです。しかし配布されるのは、その文だけではなくビルドしたサイト一式です。古い記事一覧を使って一式を作れば、案内文の修正と同時に記事の集合も過去へ戻ります。
確認した最新版の配布物には、2記事に加えて、404ページと公開確認用のJSONもありませんでした。ツール用のデータ4ファイルも欠落していました。ゲームやツールの変更と記事の追加が同じサイトへ入る構成では、配布元の食い違いが別の場所にも波及します。
今回の根本的な問題は、ローカルにファイルがあれば十分と扱ったことです。公開処理が更新するファイルを、次の手動配布でも使う正本として保存し、引き継ぐ工程が必要でした。
HTTP 200が返っても、記事があるとは限らなかった
存在しない記事のURLが200を返したのは、Cloudflare PagesのSPAフォールバックが働いたためです。トップレベルに404.htmlがない場合、対応する静的ファイルがないパスへルートのページを返す動作が、公式の配信仕様に説明されています。
SPAでクライアント側のルーターが処理するなら、この動作には用途があります。今回のブログは記事ごとにHTMLを生成する構成だったので、記事欠落がトップページの正常応答に見えてしまいました。
同じことが公開確認用のJSONにも起きました。予約処理がそのURLを取得すると、JSONではなくトップページのHTMLが返ります。それを解析しようとしてJSONエラーになり、次の記事の公開前に停止していました。
止まったこと自体は、別の配布物を無条件で上書きしないために必要な動作です。ただし解析エラーだけでは、配布物の置き換わりを説明できません。修正後は、HTMLや不正なJSONが返った場合、公開マーカーを取得できないことと、既公開記事・配布基準の再確認が必要なことを明示して停止するようにしました。
復旧は、古い配布物へ丸ごと戻す方法を避けた
最後に記事が存在した版へ戻せば、2記事だけは復元できるかもしれません。しかし、それ以降に公開した書籍案内まで古い内容へ戻る可能性があります。
そこで、直近の本番配布物を確保し、実際の配信内容と照合しました。その内容を保ったうえで、公開成功履歴に対応する2記事、表紙、404ページ、公開マーカーを復元しました。欠落したツール用データも、以前の検証済み配布物のハッシュと一致するものを戻しています。外部から最新データを取り直す作業は混ぜていません。
復旧した57記事版を確認してから、期限を過ぎていた予約記事を通常の処理で1本だけ公開しました。残る原稿をまとめて出さず、実配信確認から72時間以上空ける既存のルールを維持しました。
10月23日の復旧時点では58記事を監査し、エラー・警告とも0件でした。配信対象の418ファイルも配布物と照合しました。これはその時点の技術的な確認であり、Googleがいつ記事を再取得するかまで保証するものではありません。
配布前に比べるのは、記事数だけではない
追加した検査では、現在の公開原本と公開履歴を読み、配布物に含まれる記事の集合を比べます。同じ件数でも、別の記事へ入れ替わっていれば失敗にします。
| 確認対象 | 見つけたい不備 |
|---|---|
| 公開原本と公開履歴 | 成功済みの記事が原本から落ちていないか |
| 配布物の記事URL集合 | 既公開記事の欠落、未公開記事の混入がないか |
| サイトマップ | 配布する記事の集合と一致するか |
| 既公開記事のHTML | 本文と、その記事自身のcanonicalがあるか |
| 404と公開マーカー | 欠落URLを隠さず、最新の公開履歴を引き継いでいるか |
| ツール用データ | 別ページが必要とするファイルも残っているか |
この検査は、最新の原本と公開履歴がある側で実行します。古いコミットだけを取り出した作業場所で、古い原本と古い配布物を比べても、両方が同じように欠けていれば合格してしまうからです。
手動変更後の配布基準も更新が必要です。公開マーカーだけをコピーしても、新しいツールや案内文を次の予約ビルドへ引き継げたことにはなりません。手動配布中は予約処理を止め、配布後に原本・配布元・固定基準をそろえてから再開する手順にしました。
予約処理の成功を、次の更新まで引き継ぐ
今回、予約公開は最初の時点では成功していました。欠けていたのは、その成果を次の配布経路へ渡す仕組みでした。
同じ構成を使うなら、まず「予約処理が更新するファイル」と「手動配布が入力にするファイル」を並べてみてください。公開原本、表紙、404、公開マーカーのどれかが片方にしかなければ、次の更新で失われる可能性があります。
配布の成功ログに加えて、最新原本との集合比較と、本番URLの本文確認を残す。その二つが、今回のような公開後の欠落を見つける手掛かりになりました。
