動かないときの切り分け手順
原因を探す順番を決めたら、早く終わるようになりました。

この記事の結論
- 原因を探す前に、範囲を狭める
- 直前の変更を戻すのが最初
- 一度に1つだけ変える
- 原因を探す前に、範囲を狭める
- 直前の変更を戻すのが最初
- 一度に1つだけ変える
動かないとき、あちこち触って余計に分からなくなった。順番を決めた記録を書く。
やってはいけない対応
まず、失敗したやり方を書く。
- 思いついた箇所を次々触る
- 複数の変更を同時に入れる
- どれが効いたか分からなくなる
3つ目が最悪の状態だ。直っても、原因が分からない。
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つが原因だと分かる。切り分けそのものが不要になる。
あわせて読む
- 不具合を直す順番を決めたら、原因に辿り着くのが速くなった — 手当たり次第に試していました。切り分けの順番を決めた話です。
- 大きく作り替えるより、少しずつ変えるほうが速かった — 一度に作り直して失敗しました。段階を踏む形に変えた話です。
- AIにコードを直させるとき、範囲を区切らないと別の場所が壊れる — 1か所の修正を頼んだつもりが、関係ない機能が止まりました。範囲の伝え方と、巻き込みを防ぐ手順です。
まとめ
- 最初にやるのは、直前の変更を戻すこと
- 原因を探す前に、起きる条件で範囲を狭める
- 一度に1つだけ変え、戻してから次を試す
- 再現する最小の形にすると、原因が見える
- 原因を確定する前に、直さない
新しい記事が出たら、ブラウザの通知でお知らせします。
メールアドレスの登録は要りません。いつでも止められます。
関連記事
RELATED
圧縮できるのは、冗長度があるから。情報の量の測り方を図にした
情報の量は意味では測りません。どれだけ絞り込めたかで測ります。1948年の論文が置いた定義と、英語の冗長度が約50%とい…
HOKKAIDO AI LAB を英語でも読めるようにしました。ボタン1つで翻訳、英語のページを作らなかった理由も
海外から読んでくださる方のために、ヘッダーに英語の翻訳ボタンを付けました。押すと、いま見ているページがその場で英語になり…
相席か個室か。1つの仕組みを何社で使うかを図にした
共有するか分けるかは0か1ではありません。層ごとに決められます。4つの構成と、それぞれで何を引き受けることになるのかを整…