不具合の原因を切り分ける
要点
表示されない・エラー・押せない・急に崩れたときに、いきなり直さず、症状・いつから・範囲・層(DNS/サーバー/WordPress/ブラウザ)の順に絞り込む。
使う場面
- サイトが表示されない、500エラー、白い画面
- ボタン・リンクが押せない、急に崩れた、スマホだけおかしい
- フォーム・メールだけ動かない
最初に確認
- 何が起きているか(エラー文はそのまま控える。画面のスクリーンショット)
- いつから・直前に何を変えたか(更新・設定・CSS・DNS)
- 全員か一部か、PCかスマホか、別の回線でも同じか
- 戻せるバックアップがあるか
手順
- 症状を正確にする: 何をすると、どうなるか。再現する条件(ページ・幅・ブラウザ・ログイン有無)。
- 範囲を決める: 全員 → サイト・サーバー・DNS。一部 → キャッシュ・端末・回線・DNS反映途中。
- 層を順に確認する: DNS → サーバー(障害情報・容量・契約)→ WordPress(500・管理画面)→ プラグイン → 外部サービス → ブラウザ(Console・Network)。
- ログを見る(エラーログ・コンソール)。
- 仮説を1つずつ確かめる。一度に1つだけ変え、変えるたびに確認する。
- 直らなければバックアップから戻す(承認を取ってから)。
全体の確認表は 障害対応の基本(いきなり直さず症状を切り分ける14の確認順)。
Claude / AIへ送る指示
まず原因調査だけしてください。修正・設定変更はしないでください。
【何をしたか】〔直前の操作・変更〕
【期待した結果】〔…〕
【実際の結果】〔…〕
【エラー文】〔そのまま。トークン・個人情報は伏せる〕
【いつから】〔最後に正常だった日時〕
【環境】〔PC/スマホ・ブラウザ・対象URL〕
【確認済み】〔キャッシュ削除済み・HTTP 200 など〕
HTMLを読むだけで判定せず、実ブラウザやログで確かめてください。
原因の候補と確認方法、最小の修正案を出して止まってください。
コマンド
【読み取り】 表示されない・エラーのとき:
Resolve-DnsName 〔ドメイン〕 -Type A
curl.exe -sI https://〔ドメイン〕/ | Select-String -Pattern "^HTTP|location|server"
wp core version --skip-plugins --skip-themes
wp plugin list --fields=name,status,version,update --skip-plugins --skip-themes
tail -n 50 〔エラーログのパス〕
【読み取り】 押せない・重なりが疑わしいとき(ブラウザのコンソール。要素を選んで $0):
const r = $0.getBoundingClientRect(); document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2)
最後の確認
- 原因と直した内容を1行で説明できる
- 同じ手段で再検査して直っている(PC・390px・実クリック)
- 原因と対処をナレッジに残す価値があれば残す(ナレッジを追加・更新してサイトへ同期する)
注意点
- いきなり修正しない。複数を同時に変えると原因が分からなくなる。
- ログ・エラー文をAIに渡すときは、URL内のトークン・メールアドレス・注文番号を伏せる(ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意)。
- 改ざん・不正アクセスの兆候があれば、修正より先に状況保存と隔離(不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策))。