AI 可以快速整理接口文档，但接口文档整理不等于业务链路测试设计。

常见问题是：AI 把接口、字段、请求参数、返回参数整理得很完整，但没有把接口放回真实业务路径里。

最终表现为：

• 接口顺序不清楚。
• 字段来源不明确。
• 前置数据不可执行。
• 断言只验证响应成功。
• 状态流转没有闭合。
• 异常只覆盖单接口参数错误。

下面是几个最容易翻车的点。

1. 按接口列表整理，而不是按用户路径整理

接口文档通常按模块或接口名称组织，例如：

• 登录接口。
• 查询商品接口。
• 试算接口。
• 创建订单接口。
• 支付接口。
• 查询订单接口。

AI 很容易直接按这个顺序整理。

但业务链路测试要回答：

• 用户从哪个入口触发链路？
• 哪些接口只是查询？
• 哪些接口会改变状态？
• 哪些接口必须按顺序调用？
• 哪些接口只是分支或补充校验？

示例：下单支付链路。

用户登录
  -> 查询商品可售状态
  -> 试算价格和优惠
  -> 创建订单
  -> 发起支付
  -> 支付回调
  -> 查询订单详情
  -> 查询支付流水

这里的重点不是 “有几个接口”，而是接口之间为什么按这个顺序发生。

2. 字段来源和去向不清楚

业务链路测试最容易卡在字段依赖。

常见字段：

• token。
• userId。
• skuId。
• couponId。
• orderId。
• payNo。
• requestId。

需要明确：

• 字段来自哪个前置接口。
• 哪些字段来自预置数据。
• 哪些字段来自后台配置。
• 哪些字段需要动态提取。
• 哪些字段会写入后续接口或数据库状态。

建议让 AI 输出链路表时增加两列：

字段来源 | 字段去向

如果字段来源不清楚，后续自动化脚本很容易依赖硬编码数据，稳定性会很差。

3. 只验证响应，不验证业务结果

接口测试不能只看：

HTTP 200
code = 0
message = success

这些只能说明接口层响应成功，不能证明业务结果正确。

创建订单成功后，应继续验证：

• 订单是否生成。
• 订单状态是否为待支付。
• 金额是否正确。
• 库存是否锁定。
• 优惠券是否占用。
• 订单详情接口是否可查询。

支付成功后，应继续验证：

• 订单状态是否变为已支付。
• 支付流水是否生成。
• 优惠券是否核销。
• 库存是否扣减。
• 用户权益是否发放。
• 异步消息是否被消费。

业务链路测试需要后续校验接口，不能只停在当前接口响应。

4. 异常链路只写单点失败

AI 常见异常输出：

• 参数为空。
• 参数格式错误。
• 权限不足。
• token 过期。

这些是单接口异常，不是链路异常。

链路异常应按阶段设计：

• 前置查询失败。
• 试算失败。
• 创建订单失败。
• 支付失败。
• 回调失败。
• 重复请求。
• 超时重试。
• 补偿任务失败。

示例：

创建订单成功，但支付失败：
1. 订单状态应停留在待支付或支付失败。
2. 库存是否释放取决于业务规则。
3. 优惠券是否退回取决于业务规则。
4. 用户是否可以重新支付。
5. 是否生成失败支付流水。

链路异常的重点是状态一致性，而不是简单返回错误提示。

5. 主链路和分支链路没有分层

AI 容易把所有接口平均展开，导致用例数量很多，但优先级不清楚。

业务链路测试建议分三层：

• 主链路：最核心、最高频、必须优先验证。
• 关键分支：影响资金、库存、权限、状态的分支。
• 低频补充场景：特殊配置、历史数据、低频异常。

以下单支付为例：

• P0：正常下单并支付成功。
• P0：支付成功后订单、流水、库存、优惠券状态正确。
• P1：库存不足、优惠券不可用、支付失败。
• P1：重复支付、重复回调、超时重试。
• P2：特殊商品、后台改价、跨端同步。

优先级不是装饰，它决定时间不够时先测什么。

推荐提示词

请不要只整理接口列表。

请基于接口文档生成业务链路测试设计，按真实用户路径组织。

每条链路包含：
1. 业务目标。
2. 接口调用顺序。
3. 字段来源和去向。
4. 前置数据。
5. 关键断言。
6. 后续校验接口。
7. 状态流转。
8. 异常分支。
9. P0/P1/P2 优先级。

请区分主链路、关键分支和低频补充场景。

接口文档：
{粘贴接口文档}

评审清单

可以用下面几个问题审 AI 输出：

• 是否按真实用户路径组织，而不是按接口文档顺序？
• 每个字段是否说明来源和去向？
• 是否包含前置数据准备方式？
• 是否有后续校验接口？
• 是否验证业务状态，而不只是响应成功？
• 是否覆盖链路异常，而不只是单接口异常？
• 是否区分主链路、关键分支和低频场景？
• 是否标注 P0/P1/P2 优先级？

AI 适合快速整理接口文档，但测试工程师需要把接口重新放回业务链路里。

接口文档告诉你有哪些接口，业务链路告诉你这些接口为什么要按这个顺序发生。