测试失败时需先确认是测试未同步更新还是功能存在缺陷：比对测试断言与真实行为、手动调用验证输出、注释断言定位问题、用git对比测试与功能修改时间线，并借助codex交叉验证契约一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Codex 中运行测试后看到失败提示，不能直接断定是测试代码写错了，还是被测功能本身就有问题——因为两者都会导致测试不通过，但修复方向完全相反：改测试还是改功能，取决于哪边偏离了真实契约。
先确认测试用例是否描述了当前功能行为
打开测试文件，找到报错的用例，逐行比对它断言的内容和你手动操作时的真实表现。例如测试写的是 expect(result).toBe("success")，但你手动调用函数返回的是 { status: "ok", data: [] }，说明测试仍按旧接口契约编写，而功能已升级。这时候不是功能有 bug，是测试没同步更新。
这一步必须做。Codex 有时会基于过期的文档或旧版本代码生成测试，尤其当项目近期重构过接口结构时，测试很可能还在验证一个已经不存在的返回格式。
检查被测函数/接口是否在真实环境中能执行
方法一：跳过测试，直接在终端或浏览器控制台调用该函数或发起请求
比如测试报错在 loginUser()，那就手动执行 loginUser({ email: "a@b.c", password: "123" })，观察返回值、控制台错误、网络面板响应体和状态码。如果返回 400 或抛出未捕获异常，说明功能确实有问题；如果返回符合预期的数据，那大概率是测试断言写窄了、路径写错了，或者 mock 数据没配对。
方法二：临时注释掉测试中的断言，只保留执行语句，再运行一次
把 expect(...).toBe(...) 整行用 // 注掉，重新跑这个用例。如果不再报错，且控制台输出了合理结果，基本可锁定是断言逻辑与实际输出不匹配——也就是测试写错了。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
用 Code Diff 对比测试修改和功能修改的时间线
第一步：执行 git log -p --grep="test" -n 5，找出最近五次涉及测试的提交
第二步：对每条提交执行 git show <commit-hash> -- test/</commit-hash>，看测试新增或修改了哪些断言
第三步：执行 git show <commit-hash> -- src/</commit-hash>（或对应功能目录），确认同一时间段内功能代码是否也被修改过
【如果测试改动发生在功能改动之后，且断言未同步更新，那测试就是错的】 比如功能上周把 getUserName() 改成返回对象，而测试今天才加了一条用字符串做断言的用例，这个用例从一开始就不该通过。
让 Codex 帮你交叉验证契约一致性
方法一：给 Codex 发送指令：“请对比以下两段内容，指出它们在数据结构、字段名、返回类型上是否存在不一致：① 当前 src/api/user.ts 中 fetchProfile() 的实际返回类型定义；② test/user.test.ts 中第 42 行测试用例的 expect 断言。”
方法二：让它生成最小复现脚本：输入“请写一段可在 Node 环境直接运行的 JS 脚本，调用 fetchProfile() 并打印完整返回值，不依赖任何 mock”，然后你复制执行，把真实输出贴回去让 Codex 对比测试断言。
注意：不要让 Codex 只看测试文件就下结论。它需要同时看到功能实现和测试断言，才能判断哪边违背了双方约定。
