接口快照回归：字段新增不是小事

2026年3月记录，分类「接口测试」。这是一篇偏实战的记录，保留了当时的判断过程和后续沉淀。

为什么做快照

接口字段新增看起来兼容，但可能影响前端展示、导出、搜索、三方调用和缓存结构，所以快照回归要判断变化是否符合预期。

这类问题如果只写结论，过一段时间就很难复用，所以我把判断依据也留了下来。

快照粒度

• 核心接口保存字段结构、类型和关键枚举。
• 对允许变化的动态字段做忽略规则。
• 字段变化时要求关联需求或接口文档。

{"id":"number","status":"enum:pending|paid|cancelled","amount":"decimal"}

变化判断

• 字段删除、类型变化、枚举变化能被发现。
• 新增字段有兼容性评估。
• 快照失败不是因为时间戳等动态值。

如果要自动化，我会先挑稳定、关键、失败后能定位的部分，不急着全量脚本化。

实践

接口快照不是为了卡开发，而是让接口变化可见、可讨论。这个记录后续还可以继续补真实缺陷样本，让它从笔记变成团队检查清单。