专题 C2：API 调试
OpenAPI 调试流程清单
很多 API 故障并不是代码本身坏了，而是规范、客户端和服务实现之间对契约理解不一致。
按顺序排查，别跳步骤
先确认到底命中了哪一个 operation，再核对 path 参数、query、headers 和 request body 的真实结构。
如果连目标契约都没对准，就直接抓服务日志，通常只会越看越乱。
重放与比对要看原始数据
- 用可重复的工具重放请求，并保留原始 headers 和 body。
- 把真实响应码和 schema 与规范逐项对比，而不是只看“成功/失败”。
- 问题修复后同时更新实现或规范，再跑一次契约检查，避免同样问题回归。
实用输入/输出示例
输入
spec: POST /orders -> 201 actual: POST /orders -> 200
输出
发现 contract mismatch 动作：修正服务实现或更新规范中的响应状态