【AI Native开发-11】测试全绿，也可能什么也没测到：问题出在哪？

flowchart TD
    A["一条文本用例"] --> B{"要验证哪一层契约？"}
    B --> C["单元：纯业务规则"]
    B --> D["接口 / 集成：路由 + 中间件 + 存储"]
    B --> E["E2E：关键用户路径"]
    C --> F["复用 fixture，准备独立数据"]
    D --> F
    E --> F
    F --> G["断言行为与副作用"]
    G --> H["用特定错误实现做变异检查"]
    H --> I["独立 · 可重复 · 可追溯"]

选择原则：问"这条用例验证的是哪一层的契约？"

单元测试（快、多、隔离）：
  - 验证纯逻辑：状态判断、权限判断、校验函数
  - 例：hide: true 可删 / hide: false 不可删的判定逻辑
  - TEST-003 状态边界的核心判定

接口 / 集成测试（中速、真实协作）：
  - 验证真实 HTTP 路由 + 真实中间件 + 真实文件操作
  - 权限中间件【不 mock】，用真实登录态
  - 例：TEST-002 权限、TEST-005 服务端二次校验、TEST-001 完整删除
  - 文件操作用临时目录，不碰 src/content

E2E 测试（慢、少、关键路径）：
  - 验证用户真实操作路径，跨前后端
  - 只覆盖关键用户旅程和"前端行为"类断言
  - 例：TEST-004 取消确认不发请求（必须在浏览器层才测得到）

TEST 编号     层级    文件                        关键断言                数据准备
TEST-001-1   接口    tests/api/delete.test.ts    204 + 文件消失          临时未公开文章(hide:true) + admin
TEST-002-1   接口    tests/api/delete.test.ts    403 + 文件仍在(副作用)   临时未公开文章 + 普通用户
TEST-002-2   接口    tests/api/delete.test.ts    401 + 文件仍在           临时未公开文章 + 未登录
TEST-002-3   接口    tests/api/delete.test.ts    伪造角色仍 403 + 文件仍在  普通用户 + admin 角色参数
TEST-003-1   接口    tests/api/delete.test.ts    409 + 文件仍在           临时已公开文章(hide:false) + admin
TEST-004-1   E2E     e2e/delete-cancel.spec.ts   无 DELETE 请求发出       临时未公开文章 + admin
TEST-007-1   接口    tests/api/delete.test.ts    第二次返回 404            临时未公开文章 + admin

写测试前先做调研（只读）：
1. 项目用什么测试框架？命令是什么？（看 package.json）
2. 现有的测试登录 / 认证 fixture 在哪个文件？怎么用？
3. 有没有测试数据工厂 / builder？
4. 接口测试怎么起服务、怎么发请求？
5. 临时文件 / 目录怎么创建和清理？（beforeEach/afterEach）

要求：
- 登录态【必须】复用现有 auth fixture，不要自己 mock 认证中间件
- 测试数据【必须】在临时目录创建（如 tmp/ 或 os.tmpdir），
  绝不能用 src/content 下的真实文章
- 每个测试结束后清理自己创建的数据（afterEach）
- 断言工具、请求工具复用现有的
- 如果现有设施缺东西（比如没有普通用户登录的 fixture），
  先提出来，不要默默 mock 掉

import { vi } from "vitest"
import { api, readArticleFromStore } from "./helpers"

// ❌ 只调用并检查 mock 自身，没有经过任何被测系统
const deleteArticle = vi.fn().mockResolvedValue(undefined)
await deleteArticle(articleId)
expect(deleteArticle).toHaveBeenCalledWith(articleId)

// ✅ api 是配置了 baseURL 的测试客户端；直接检查受控测试存储
const res = await api.delete(`/api/articles/${article.id}`, { headers: adminAuth })
expect(res.status).toBe(204)
await expect(readArticleFromStore(article.id)).resolves.toBeNull()

// 使用同一受控测试存储和已配置的 API 客户端
const res = await api.delete(`/api/articles/${article.id}`, { headers: normalUserAuth })
expect(res.status).toBe(403)

// GET 200 不等于文件存在：可能来自缓存、快照或另一个数据源
await expect(readArticleFromStore(article.id)).resolves.toMatchObject({ id: article.id })
// 如 Spec 有要求，再检查索引、图片与其他关联副作用

let deleteCalled = false
page.on("request", (req) => {
  if (req.method() === "DELETE") deleteCalled = true
})

await page.getByRole("button", { name: "删除" }).click()
await page.getByRole("button", { name: "取消" }).click()

// 断言"什么都没发生"，比断言"弹窗关了"更接近 Spec 原意
expect(deleteCalled).toBe(false)

断言用户 / 系统可观察的结果：
  ✓ 返回的状态码、响应体
  ✓ 数据的最终状态（文件在不在、记录变没变）
  ✓ 副作用（请求有没有发出、关联数据动没动）
  ✓ 界面可见的变化

不要断言内部实现：
  ✗ 某个内部函数被调用了几次
  ✗ 某个私有变量的值
  ✗ 弹窗组件的内部 state（除非这就是要测的行为）

数据隔离：
- 每个测试自己造数据（用工厂 / builder），不依赖共享的固定数据
- 数据造在临时位置，绝不动 src/content 等真实内容目录
- beforeEach 准备，afterEach 清理，保证测试可独立、可乱序、可重复运行

幂等验证：
- 重复操作的用例（TEST-007），第二次明确返回 404（文章不存在）
- 断言第二次请求不会产生额外副作用，且系统状态一致

独立性：
- 测试之间不共享可变状态
- 一个测试的失败不影响其他测试运行

- 测试变红：说明它能抓住“固定成功”这个错误实现
- 测试仍绿：说明它对这个错误没有保护能力，应检查 mock 与断言