principle-fix-root-causes

根本原因を修正する

デバッグ時は、症状を修正しないでください。問題の根本原因を突き止め、そこで修正してください。

理由： 症状への対処は積み重なります。回避策を追加するたびにシステムの把握が難しくなり、根本的なバグは残ったままです。根本原因の修正には最初に時間がかかりますが、デバッグにかかる時間の総量を減らせます。

手順：

• まず問題を再現します
• 根本原因にたどり着くまで「なぜ」と問い続けます
• ガードを追加しないでください（クラッシュを抑えるために nil チェックを追加するのは、症状への対処です）
• 回避策を正当化するのに段落ほどのコメントが必要なら、コードに問題があります（コメントではなくコードを修正してください）
• 個別の事例だけでなく、パターンを確認します（同じパターンを grep で探し、すべて修正してください）
• 行き詰まったら、計測してください。推測してはいけません（ログを追加し、実際のエラーを確認してください）

再起動に関するバグ：コードより先に状態を疑う

何かが「再起動後に失敗する」場合は、まず古い永続状態を疑ってください。設定ファイル、キャッシュ、ロックファイル、シリアライズされた状態などが該当します。状態ファイルを消去すると動作が回復する場合は、状態の検証を修正の優先事項にしてください。