接口测试清单是什么
接口测试清单把一次完整接口测试应覆盖的维度固化成检查项：正向与参数组合、鉴权与越权、错误码与错误体、边界与畸形输入、并发与幂等、限流重试、依赖异常、数据一致性、契约一致性、可观测字段。清单的作用是把「每次靠记忆」变成「逐项勾选」，让覆盖面的漂移无处藏身，也是新人快速达到团队最低覆盖标准的抓手。
常规覆盖维度
- 正向路径与参数组合：必填、选填、默认值逐项确认。
- 鉴权失效、权限不足与越权对象：401、403、跨用户数据分开断言。
- 错误码与错误体结构：具体错误码、字段级提示、结构稳定。
- 边界值、畸形输入与超长字段：长度红线与类型污染都要试。
- 并发、重复提交与幂等：同一请求重放只生效一次。
- 限流与重试行为：429 触发条件、Retry-After 与恢复窗口。
- 依赖超时、降级与熔断：下游故障时的返回与兜底策略。
- 数据一致性：写入后读到的状态、缓存与库是否一致。
- 契约与文档一致性：字段类型、必填性与向后兼容。
- 日志与可观测字段：trace id、关键业务字段是否可追踪。
基本信息
| 分组维护 | 鉴权、幂等与限流单独设用例集，便于专项回归 |
|---|---|
| 覆盖抽查 | 每版本抽查清单项与用例的对应关系 |
| 执行时机 | 接口评审时按清单过一遍，合并前自动化回归 |
| 固化方式 | 写进评审模板与自动化套件骨架，不靠个人记忆 |
| 配合方法 | 参数组合用等价类与边界值设计，规模大时用 pairwise |
分组与典型断言
| 分组 | 关键断言 | 常见遗漏 |
|---|---|---|
| 鉴权 | 401 与 403 语义分开、越权对象拒绝 | 只测一个角色、越权不测 |
| 幂等 | 重放请求只生效一次、返回一致 | 重复提交导致双倍数据 |
| 限流 | 429 加 Retry-After、窗口恢复 | 只验证被限流，不验证恢复 |
| 契约 | 字段类型与必填性、向后兼容 | 文档改了实现没跟，或反之 |
| 一致性 | 写入后读取、缓存与库一致 | 只测单次请求不管状态流转 |
把清单固化到评审模板里，逐版本勾选，避免「每次靠记忆」的覆盖漂移。
接口测试可以先于 UI 完成：契约与样例数据一稳定就能开工，比等页面联调完再测至少提前一个环节。
清单只管覆盖面，深度靠具体用例设计：勾满清单不等于测好，参数组合仍要按等价类与边界值展开。