Codex作業で困った時のトラブル対応
404、500、CSS崩れ、SEOタグ変更、sitemap.xml / robots.txt、アップロード先、cron、報告書のズレを、止める・戻す・確認する観点で整理します。
Rollback trouble
Codex作業で問題が出た時は、広げて直すより、まず止めて、直前変更と確認結果を切り分けます。
このページは非公式の実践ガイドです。Codexの仕様や利用条件は変わる可能性があります。最新情報が必要な場合は提供元の情報を確認してください。
Codexは便利ですが、対象ファイルの誤認、想定外の差分、リンク切れ、表示崩れ、HTTP 500や404などが起きることはあります。大事なのは、問題が出た時に作業を広げず、停止条件に従って止めることです。
原因が分からないまま大規模削除や設定変更を重ねると、戻しにくくなります。直前変更だけを戻す、戻す対象を明記する、戻さないファイルを決める、戻した後に確認する、という流れにします。
.htaccess、DB、cron、共通パーツ、sitemap、robots、ads.txt、Search Console確認ファイル、重要な接続情報を含む可能性があるファイルは、軽く変更しない方が安全です。必要な場合でも、まず調査と提案だけに分けます。
HTTP 200、SEOタグ維持、noindexなし、内部リンク、CSS読み込み、スマホ表示、変更ファイル、戻していないファイルを確認します。戻した後も人間が公開状態を見ることが必要です。
| 悪い例 | 良い例 |
|---|---|
| 原因不明のまま大きく削除する | 直前変更だけ戻す |
| 関連しないファイルも戻す | 戻すファイルと戻さないファイルを分ける |
| 戻した後に確認しない | HTTP 200とSEOタグ維持を確認する |
直前の変更だけを戻してください。戻す対象ファイル、戻す理由、戻さないファイル、確認URLを明記してください。大規模削除や無関係ファイル変更は禁止です。戻した後に HTTP 200、SEOタグ維持、内部リンクを確認してください。
失敗に気づいた直後の数分が、復旧の難しさを決めます。やってはいけないのは、慌てて追加の修正を頼むことです。原因が分からないまま変更を重ねると、どこまで戻せばよいかが分からなくなります。
3番を飛ばして「直して」と頼むのが、いちばんよくある悪化のパターンです。何が変わったか分からないまま次の変更を加えると、元の状態が再現できなくなります。
常に戻すのが正解ではありません。次で判断します。
| 状況 | 判断 | 理由 |
|---|---|---|
| 公開中のページが表示されない・大きく崩れている | すぐ戻す | 原因追及は後でよい。見えている被害を先に止める |
| 変更範囲が広く、どこが原因か分からない | 戻す | 切り分けに時間がかかる。戻してから小さくやり直す |
| 崩れが1ページ・1箇所で、原因も見当がついている | 直す | 戻すと他の正しい変更まで消える |
| 戻すと、同じ作業でうまくいっていた分まで消える | 直す方を検討 | ただし直せる確信がない場合は戻すほうが早い |
| バックアップが無い | 直すしかない | この状況を作らないことが本来の対策 |
迷ったら戻す側を選んでください。戻してから小さくやり直すほうが、原因不明のまま直し続けるより結果的に速く終わります。
「戻した」と報告されても、実際には戻りきっていないことがあります。次を自分の目で確認してください。
確認が終わったら、次に同じことが起きないための1行を残してください。「〇〇を頼む時は対象フォルダを1つに絞る」といった短いメモで十分です。原因を書き残さないと、数週間後に同じ手順で同じ失敗をします。
作業前はテンプレート、作業後は報告書、公開前後はチェック、問題が出たら戻し方へ進みます。
なお、戻ったかどうかを機械的に検査するコードを書く場合、数を数えるだけの検査は通ってしまいます。タグの開閉数を数えると、変更前から合っていない箇所まで拾って「壊れている」と出ますし、1回だけ見るとキャッシュの揺れで誤判定します。実際に出た偽陽性・偽陰性と、その直し方(絶対数ではなく変更前後の差分で見る、否定形で判定しない)はAIに書き換えさせた結果を検査するコードの書き方にまとめてあります。
検索や個別ページから入った場合は、親カテゴリや近い実務ページへ進むと全体像をつかみやすくなります。
404、500、CSS崩れ、SEOタグ変更、sitemap.xml / robots.txt、アップロード先、cron、報告書のズレを、止める・戻す・確認する観点で整理します。
Codexに頼む前、作業テンプレート、作業後チェック、トラブル対応、実践ログを、使う場面ごとに選べるように整理しました。
テンプレート、チェックリスト、トラブル対応、実践ログを、Codex作業マニュアルとして使えるようにまとめました。