Codex trouble guide

Codex作業後に404が出た時の確認

Codex作業後に404が出た時の確認方法を整理します。URL確認、ファイル配置、リンクミス、sitemap.xml、rewrite、戻す前の確認を扱います。

このページは非公式の実務ガイドです。重要な判断は人間が行い、最新情報は提供元の情報も確認してください。
trouble-check.md
stop:
  - unclear_cause
  - risky_change
check:
  - public_url
  - changed_files
  - rollback_scope

このページで分かること

Codex作業後に404が出た時の確認方法を整理します。URL確認、ファイル配置、リンクミス、sitemap.xml、rewrite、戻す前の確認を扱います。

起きている症状

ページが見つからない、トップは表示されるのに下層ページだけ開けない、追加したリンク先が404になる状態です。

最初に確認すること

404の切り分けは「ファイルが無いのか、場所が違うのか、URLが違うのか」の3択です。この3つを順に潰せば、原因は必ず特定できます。

確認やり方そこから分かること
URLの末尾スラッシュ・綴り/page と /page/ の両方を試し、ディレクトリ名の綴りを見るファイルは存在するのにURL表記だけ違うケース(最頻出)
配置先と公開ディレクトリの対応FTPで実際のファイルの場所を見るローカルの階層と公開側の階層がずれてアップロードされていないか
リンク元のhrefが実在URLかリンク元HTMLのhrefと、実際に存在するディレクトリを照合「後で作るつもり」の未作成URLへ先にリンクしていないか
sitemapのURLと実ファイルの場所sitemap.xmlに書いたURLへ直接アクセスsitemapだけ先に更新して実体が無い状態になっていないか
rewrite設定を触っていないか.htaccess等の変更履歴を見るURL書き換えルールの変更で、既存URLが全滅していないか

index.htmlの置き場所にも注意してください。「/page/index.html」を作るつもりで「/page.html」を置く(またはその逆)は、Codexへの指示があいまいな時に起きやすい取り違えです。ディレクトリ+index.html方式かファイル直置き方式か、サイトの流儀を指示に明記すると再発を防げます。

Codexに再確認させる指示文

Codex作業後に404が出ています。対象URL、配置されたファイル、内部リンク、sitemap.xml、rewriteに関係する設定を確認し、戻す前に原因候補を一覧で報告してください。SEOタグや重要ファイルは変更しないでください。

やってはいけないこと

  • 原因不明のまま大量にファイルを移動する
  • 未作成URLへリンクを残す
  • rewrite設定を大きく書き換える
  • sitemap.xmlだけ直して表示確認をしない

戻す判断

対象ファイルの配置ミスやリンクミスなら最小修正します。rewriteや共通設定に関係しそうな場合は、直前変更を戻す候補を先に整理します。

直した後に404が「残って見える」理由

原因を直したのに404が消えないように見える時は、修正が失敗しているのではなく、古い状態がどこかに残っているだけのことがよくあります。慌てて二重に修正する前に、この3つを疑ってください。

  • ブラウザキャッシュ:直前まで404だったURLは、ブラウザが404の結果を覚えていることがあります。シークレットウィンドウか別ブラウザで開き直すと、実際の今の状態が分かります。
  • Search Console上の404報告:GSCの「見つかりませんでした(404)」の一覧は過去のクロール結果です。直した後もしばらく表示され続けるのは正常で、再クロールされれば消えていきます。修正当日に消えないことを異常と判断しないでください。
  • リンク元の直し忘れ:404ページ自体を作って解決した場合でも、古いURLへ張られたリンクが他ページに残っていれば、そこを踏んだ人はまた404に落ちます。「URLを変えた」対応をした時は、site内のリンク元を横断確認します。

逆に、確認して「本当にまだ404」だった場合は、修正したファイルが別の場所にアップロードされている(配置先の取り違え)ケースが最有力です。修正の中身より「どこに置いたか」を先に見てください。

確認チェックリスト

  • 対象URLが200 OK
  • 親ページからのリンクが200 OK
  • sitemap.xmlが200 OK
  • 内部リンク404がない
  • トップページと主要ページが表示される

次に読むページ