042、Bug 修复全流程：从复现到定位到验证的五步工程法

042、Bug 修复全流程：从复现到定位到验证的五步工程法

上周五晚上十一点，生产环境告警响了。一个用户反馈说上传 CSV 文件后，系统返回了 500，但日志里只留下一句 NullPointerException，连堆栈都只打印了一半。我盯着屏幕看了十分钟，脑子里只有一个念头：这 bug 要是靠肉眼翻代码去找，今晚别想睡了。

Claude Code 在这种场景下，不是用来替你写代码的，是用来替你加速认知闭环的。从复现到验证，我总结了一套五步工程法，每一步都有对应的 Claude Code 操作姿势。

第一步：构造最小复现环境

大多数工程师拿到 bug 的第一反应是去翻代码，这是错的。正确的做法是先让 bug 在本地稳定复现。没有稳定复现，后面所有定位都是瞎猜。

我当时的做法是：把生产环境的请求参数 dump 下来，写一个最小化的测试用例。但 CSV 文件有 200 多列，手动构造太慢。我直接在 Claude Code 里贴了报错信息和一段伪代码：

"根据这个 NPE 堆栈和 CSV 文件头，帮我生成一个 JUnit 测试用例，
用 Mockito 模拟 FileUploadService 的行为，
只保留可能触发 NPE 的字段，其他字段用 @Mock 忽略"

Claude Code 生成了一段测试代码，我复制到 IDE 里一跑，果然复现了。关键点在于：不要让它帮你分析，而是让它帮你构造复现条件。Claude Code 对常见框架的测试模板非常熟悉，