動かないときの切り分け手順

原因を探す順番を決めたら、早く終わるようになりました。

この記事の結論

  1. 原因を探す前に、範囲を狭める
  2. 直前の変更を戻すのが最初
  3. 一度に1つだけ変える
  • 原因を探す前に、範囲を狭める
  • 直前の変更を戻すのが最初
  • 一度に1つだけ変える

動かないとき、あちこち触って余計に分からなくなった。順番を決めた記録を書く。

やってはいけない対応

まず、失敗したやり方を書く。

  • 思いついた箇所を次々触る
  • 複数の変更を同時に入れる
  • どれが効いたか分からなくなる

3つ目が最悪の状態だ。直っても、原因が分からない。

SPONSORED

1. 直前の変更を戻す

最初にやるのは、これだ。

  • 直前に変えた箇所を戻す
  • 直れば、原因はその変更
  • 直らなければ、別の原因

この1手で、半分は解決する。

2. 範囲を狭める

戻して直らない場合は、範囲を絞る。

  • どのページで起きるか
  • どの操作で起きるか
  • どの条件で起きるか

3つ目が最も効く。条件が分かれば、見る箇所が決まる。

3. 再現するか確認する

条件を確かめている。

  • 毎回起きるか
  • 時々なのか
  • 特定の条件だけか

2つ目は、原因の種類が違う。時々しか起きないものは、タイミングや量が関係している。

4. 一部を外す

範囲が絞れない場合は、外して試す。

  • 追加した仕組みを1つ外す
  • 直れば、それが原因
  • 1つずつ外す

3つ目が肝心だ。まとめて外すと、どれが原因か分からない。

5. 標準の状態で試す

それでも分からない場合、標準に戻す。

  • 追加したものを全部外す
  • 標準の状態で動くか確認する
  • 動けば、追加したものが原因

3つ目で切り分かる。土台の問題か、追加の問題かが分かる。

6. 手元で再現する

公開中のもので試さない。

  • 手元に同じ構成を作る
  • そこで再現させる
  • 何度でも試す

3つ目が目的だ。公開中だと、試せる回数が限られる。

7. 最小の形にする

再現したら、形を小さくする。

  • 関係ない部分を削る
  • 削っても再現するか確認する
  • 最小の形にする

3つ目で、原因が見える。削る過程で見つかることも多い。

記録を取りながら進める

切り分けの間、記録を取っている。

  • 何を試したか
  • 結果はどうだったか
  • 次に何を試すか

1つ目が重要だ。試したことを忘れて、同じことを繰り返す。

そのまま使える形

「動かない」は状態が複数ある。どれなのかを先に決めると、調べる場所が変わる。

  • 何も出ない(真っ白) → サーバー側で落ちている。エラーログを見る
  • エラーが出る → 文面にファイルと行がある。そこを開く
  • 画面は出るが反応しない → ブラウザの開発者ツールでJavaScriptの誤りを見る
  • 反応するが結果が違う → 値が渡っていない。受け取り側で値を出して確かめる
  • 自分だけ動かない → キャッシュかログイン状態。別のブラウザで開く

最後が多い。直したのに変わらないときは、直っていないのではなく、古いものを見ている。

一度に1つだけ変える

切り分けの原則だ。

  • 1つ変えて、結果を見る
  • 戻してから、次を試す
  • 複数同時に変えない

2つ目を忘れやすい。戻さずに次を試すと、条件が混ざる。

値を書き出す

処理の途中を確認する方法も使う。

  • 途中の値を書き出す
  • 想定と違う箇所を探す
  • 想定が間違っている場合もある

3つ目が多い。読み違えていた箇所が見つかる。

環境の違いを疑う

手元では動くのに、公開先で動かない場合がある。

  • 版が違う
  • 設定が違う
  • 権限が違う

3つ目を見落としやすい。ファイルを書き込めない場合がある。

聞くときの準備

自分で切り分けてから聞いている。

  • どこまで絞れたか書く
  • 何を試して、どうだったか書く
  • 再現する最小の形を渡す

2つ目を添えると、同じことを勧められない。

直す前に原因を確定する

原因が分かるまで、直さない。

  • 推測で直すと、症状が変わるだけ
  • 別の問題を作ることがある
  • 原因を確定してから直す

2つ目が起きた。直したつもりで、別の箇所が壊れた。

解決したら記録する

終わったら、記録に残している。

  • 症状の特徴
  • 原因
  • どう切り分けたか

3つ目が次に使える。同じ症状のとき、切り分け方から試せる。

時間を区切る

長引く場合の判断も決めた。

  • 1時間で切り分かなければ、いったん止める
  • 動く状態に戻しておく
  • 時間を置いて、やり直す

2つ目が大事だ。壊れた状態で放置しない。

切り分けを早く終えるために

普段からやっていることも書く。

  • 1つずつ変えて進める
  • 変更の記録を残す
  • 控えを取ってから触る

1つ目が効く。1つずつ進めていれば、直前の1つが原因だと分かる。切り分けそのものが不要になる。

あわせて読む

SPONSORED

まとめ

  • 最初にやるのは、直前の変更を戻すこと
  • 原因を探す前に、起きる条件で範囲を狭める
  • 一度に1つだけ変え、戻してから次を試す
  • 再現する最小の形にすると、原因が見える
  • 原因を確定する前に、直さない

新しい記事が出たら、ブラウザの通知でお知らせします。

メールアドレスの登録は要りません。いつでも止められます。

AUTHOR

北海道のWEB屋

北海道を拠点に、Web業界14年・サポート実績1,000件以上。WordPressの復旧、サーバー移転、独自ドメインとメールの設定、PHP・JavaScriptの修正まで対応します。相談と見積もりは無料です。

SPONSORED

関連記事

RELATED