principle-fix-root-causes

根本原因を修正する

デバッグでは、症状を取り繕わないでください。問題を根本原因までたどり、そこで修正してください。

理由： 症状への対処は積み重なります。回避策を加えるたびにシステムの把握が難しくなり、実際のバグは残ったままです。根本原因の修正には最初は時間がかかりますが、デバッグにかかる時間を全体として短縮できます。

手順：

• まず再現します（再現できなければ、修正を検証できません）
• 根本原因にたどり着くまで「なぜ」を問い続けます
• ガードを追加したくなる衝動を抑えます（クラッシュを抑えるために nil チェックを追加するのは、症状への対処です）
• 個々の事例だけでなく、パターンを確認します（同じパターンを grep し、すべての箇所を修正します）
• 行き詰まったら、計測します。推測はしません（ログを追加し、実際のエラーを読みます）

再起動後に起きるバグ：コードより状態を疑う

実行間でコードは変わりません。変わるのは状態です。「再起動後に失敗する」場合は、まず古い永続状態を疑ってください。設定ファイル、キャッシュ、ロックファイル、シリアル化された状態などです。状態ファイルを消すと動作が戻るなら、状態の検証を修正の優先事項にします。