principle-fix-root-causes

修复根本原因

调试时，不要修复症状。追查每个问题的根本原因，并从根源上修复。

原因： 症状修复会不断累积。每个变通方案都会让系统更难理解，而真正的 Bug 依然存在。修复根本原因前期耗时更长，但能减少整体调试时间。

模式：

• 先复现问题
• 不断追问“为什么”，直到找到根本原因
• 不要添加防护措施（添加 nil 检查来消除崩溃就是修复症状）
• 如果某个变通方案需要用一大段注释来解释其合理性，说明代码有问题（修复代码，而不是注释）
• 检查这种模式，而不只是单个实例（使用 grep 查找相同模式，并修复所有实例）
• 遇到阻碍时，添加检测手段，不要猜测（添加日志，读取实际错误）

重启问题：先怀疑状态，再怀疑代码

当某个问题“在重启后出现”时，先怀疑过期的持久化状态：配置文件、缓存、锁文件、序列化状态。如果清除某个状态文件后问题恢复正常，应优先通过验证状态来修复。