专题 C2:API 调试
如何快速 Mock OpenAPI
高质量 Mock 的关键不是“快返回点数据”,而是让响应码、字段结构和示例数据始终跟规范保持同步。
快速 Mock 的正确顺序
先确认目标 operation、请求参数和响应 schema 是否齐全,再决定要生成哪些示例 payload。
如果一开始就直接手写假数据,而不管 schema,Mock 很快会变成前后端都不信任的摆设。
让 Mock 在迭代中保持可用
- 固定状态码和关键头部,避免同一路径每次返回不同语义。
- 把样例数据做成可回放的 fixture,而不是临时拼 JSON。
- 规范变更批准后,连同 Mock 快照一起更新,避免文档和示例脱钩。
实用输入/输出示例
输入
GET /users/{id}
response schema: User输出
200 application/json
{"id":"u_123","name":"Ava","role":"admin"}