---
name: Verify统一断言改造
overview: 在 Api 上新增 Resp() 方法让 Verify 回调内可以同时做响应值断言和数据库校验，然后更新文档将统一的 Verify 模式作为推荐范式。
todos:
  - id: add-resp-method
    content: "testing_api.go: Api 新增 lastResp 字段 + Resp() 方法，execute 中调 verifyFn 前设置 lastResp"
    status: completed
  - id: update-doc
    content: "docs/Testing_API测试框架.md: 将 Verify 统一断言作为推荐范式，resp 外部断言降为兼容用法"
    status: completed
isProject: false
---

# Verify 统一断言改造

## 问题

当前 `Verify(func(a *Api) error)` 的回调只能通过 `a.DB()` 做数据库校验，无法访问响应体。导致值断言必须在外部用 `resp.GetBody()` + `resp.Fail()` 完成，逻辑分散在两处。

## 方案：Api 上新增 Resp() 方法

在 `execute` 调用 `verifyFn` 之前，把 `resp` 存到 `Api` 上，然后通过 `a.Resp()` 暴露给回调。

### 代码改动（[testing_api.go](testing_api.go)）

**1. Api 结构体新增字段**（第 46-51 行附近）：

```go
type Api struct {
    app      *TestApp
    path     string
    t        *testing.T
    session  Map
    lastResp *ApiResponse  // 新增：最近一次请求的响应
}
```

**2. 新增 Resp() 方法**：

```go
// Resp 获取最近一次请求的响应（在 Verify 回调中使用）
func (a *Api) Resp() *ApiResponse {
    return a.lastResp
}
```

**3. execute 中调用 verifyFn 前设置 lastResp**（第 296 行附近）：

在 `if passed && c.verifyFn != nil` 之前加一行：

```go
c.api.lastResp = resp
```

**4. WithSession 中传递 lastResp**（可选，因为 WithSession 创建新实例时 lastResp 默认 nil 即可，Verify 内不会跨实例调用）。

### 改动影响

- Verify 的签名 `func(a *Api) error` 不变，完全向后兼容
- 现有 Verify 回调代码无需修改
- 新的 Verify 回调可以用 `a.Resp()` 访问响应体做值断言
- 外部 `resp.GetBody()` + `resp.Fail()` 仍然可用，作为兼容方式保留

### 文档改动（[docs/Testing_API测试框架.md](docs/Testing_API测试框架.md)）

将"用例编写范式"中的推荐模式从"Verify 做 DB 校验 + 外部 resp 做值断言"改为**统一在 Verify 内完成**：

```go
resp := a.WithSession(Map{"user_id": int64(1)}).
    JSON(Map{"goods_id": goodsId, "quantity": 3, "address": "XX路1号"}).
    Verify(func(a *Api) error {
        // 响应值断言
        result := a.Resp().GetBody().GetMap("result")
        if result.GetCeilInt64("id") <= 0 {
            return fmt.Errorf("订单 ID 必须大于 0")
        }
        if result.GetString("sn") == "" {
            return fmt.Errorf("订单编号 sn 不能为空")
        }

        // 数据库状态校验
        row := a.DB().Get("order", "*", Map{"AND": Map{
            "user_id": int64(1), "goods_id": goodsId,
        }})
        if row == nil {
            return fmt.Errorf("order 表未写入订单记录")
        }
        if row.GetCeilInt64("state") != 0 {
            return fmt.Errorf("新订单 state 期望 0, 实际 %d", row.GetCeilInt64("state"))
        }
        // ...
        return nil
    }).
    Post("正常创建订单", 0, Map{
        "id": int64(1), "sn": "sample", "total_price": float64(1.0),
    })
```

文档中需要调整的位置：

- 快速开始的完整范例
- 用例编写范式的流程图和表格
- "正确请求与响应断言"小节（合并为"正确请求与 Verify 校验"）
- "不好的写法 vs 推荐的写法"对比
- 保留 `resp.GetBody()` + `resp.Fail()` 的说明但标注为兼容用法