接口测试专项

核心原则

接口 Bug 大多不在状态码，而在数据结构不一致、字段类型错配、空值处理与并发副作用。 200 只能证明"通路是通的"，证明不了"数据是对的"。

1. 先定位接口类型（决定重心）

2. 深度要求

必须覆盖的6个维度：

偏差声明：技能集通用六维标准为 功能/异常/边界/并发/安全/性能（见 docs/standards.md，装整套技能集时可得）。本技能针对 API 测试专项调整：将「边界」归入功能测试维（边界值验证是参数测试的子项）、将「并发」归入性能测试维（并发能力是 API 性能指标），新增「契约测试」与「兼容性测试」两维——这两者是接口测试的核心风险面（契约破裂与版本迁移），在通用功能测试中无独立维度。若与通用六维口径冲突，以本技能的六维为准，并在测试报告中说明。

小规模降级：上表占比适用于接口数 ≥ 5 的项目。接口数 < 5 时配额在数学上无法成立（20% 安全测试不足 1 条），此时改为「每维至少 1 条 + 覆盖率标注实际口径」，不要为凑比例编造用例。占比取整规则（先保 P0 所属维 → 向下取整 → 偏差 ≤1 条）见 references/core-flows.md。

3. 加载时机

需要时才读，不要一上来全读：

4. 工具默认选型

没别的约束就用这套：

明确"单工具全栈"诉求用 Karate。gRPC 用 grpcurl 调试（WireMock 不覆盖流式语义）。 完整能力矩阵与选型避坑见 references/tooling.md。

5. 输出格式

9 列标准表格：

上面 3 行只用于展示每列的写法，不是完整用例集。P0≤20% 等占比约束作用于最终交付的整份用例集， 不要照抄这 3 行的级别分布。完整模板见 assets/case-template.md。

方案产出顺序：接口类型定位 → 六维用例矩阵 → Mock 策略 → 自动化脚本设计 → 安全清单 → 风险提示。

6. 交付前自检

• 9 列齐全，无列错位、无单元格含 |（会破坏表格与 CSV）
• 用例编号唯一且符合 TC_{模块}_{功能}_{序号}
• P0-P3 占比符合；接口数 <5 时已注明实际分布口径
• 覆盖率已标注口径，无"全覆盖/100%"绝对化表述
• 未覆盖接口已写明"未覆盖 + 原因"
• 六维检查清单已逐项过（见 references/core-flows.md 第 8 节）

机器校验：

python scripts/validate_testcase_table.py <用例文件>

覆盖列数、编号唯一性、级别/风险取值、占比、覆盖率措辞。报错先修再交付。