一次有效的排查，从可复现的问题开始

这是用于展示技术笔记的示例文章，可按需替换。

排查时最容易丢失的，往往是刚开始看到问题时的上下文。把现象写下来，可以减少后来凭印象做判断的机会。

记录观测到的事实

一份简短的排查记录可以包含：

• 环境与版本。
• 触发问题的最小步骤。
• 预期行为与实际行为。
• 请求、日志或截图中的关键证据。

把事实和推测分开。例如，“请求返回 404”是观测结果；“部署没有上传文件”是待验证的假设。

每次只改变一个变量

同时修改配置、依赖和业务逻辑，即使问题消失，也很难知道哪个改动起了作用。

先提出一个可以被证伪的假设，再设计一个最小实验。实验结束后，记录结果，并决定下一步。

留下解决过程

找到原因以后，记录触发条件、最终修改以及验证方法。下次遇到类似问题时，这些信息比单独一行“已经修好”更有帮助。

一个有用的结尾还可以说明：哪些情况已经验证，哪些边界仍然未知。经验的价值，来自它适用的条件足够清楚。