用 Codex 自动补全缺失的单元测试与 Playwright E2E 用例:避免写出只测 Mock 不测逻辑的假测试

让 Codex 自动补单测和 Playwright E2E 时,最怕它把被测模块全 Mock 掉,造出一堆永远绿灯的假测试。本文讲清 Mock 边界划分、语义化定位器写法,以及用破坏性反向验证筛选高价值测试的实战流程。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 假测试的根源是「越界 Mock」和「过程断言」。如果只要求 Codex 提升覆盖率,它容易直接把内部模块全部打桩,最终测的只是它自己写的 Mock 返回值,真实代码改坏了测试依然绿灯。
  2. 明确划定 Mock 红线:只隔外部 I/O,不 Mock 被测核心逻辑。外部支付网关、发信服务、系统时钟和随机数允许替身隔离;业务规则、状态机、表单校验、序列化与数据库查询尽量走真实实现或轻量内存替身。
  3. Playwright E2E 遵循官方三大铁律:用户可见定位器、Web-First 断言、严禁硬编码等待。强制 Codex 使用 getByRole/getByLabel/getByTestId 定位元素,用 await expect(...).toBeVisible() 自动等待,杜绝 page.waitForTimeout()。
  4. 交付前做一次「破坏性反向验证」就能秒识假测试。临时把源码里的一个关键条件故意改错,若新生成的测试没有立刻变红失败,说明断言形同虚设,必须重写。
  5. 批量补齐多模块单测与反复跑通 E2E 调试会持续消耗额度。国内若缺少外币卡或原套餐限额不足,可在本站按需开通 ChatGPT Plus 充值 或高配额 ChatGPT Pro 充值,团队协作可了解 ChatGPT Business 团队定制。

假测试与高价值有效测试对比

图:本站根据 Playwright 官方最佳实践 与测试工程实践整理的示意图

本文根据 OpenAI Codex 官方文档《Codex CLI》《Custom instructions with AGENTS.md》及 Playwright 官方《Best Practices》《Locators》文档整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。

适用于谁

  • 想用 Codex 给历史缺测的核心业务逻辑补单元测试,或为核心主流程补 Playwright 端到端(E2E)用例的开发者;
  • 发现 AI 生成的测试看似覆盖率很高,却只断言了 toHaveBeenCalled()、或者把被测函数自己 Mock 掉的工程师;
  • 苦于 AI 写的 E2E 测试频繁出现脆弱 CSS 选择器与 waitForTimeout 硬等待、在 CI 上忽红忽绿的团队。

一、为什么 Codex 容易写出「只测 Mock 不测逻辑」的假测试

在缺乏明确测试边界约定时,Codex 为了让测试快速跑通,常常会选阻力最小的路径。以下三类是代码审查中最常见的低价值测试形态:

  • 循环自证型 Mock:把被测服务依赖的内部函数甚至被测类的方法全部 mockReturnValue,再断言结果等于刚才写死的返回值,完全没执行真实业务分支。
  • 空洞调用计数断言:只写 expect(repo.save).toHaveBeenCalledTimes(1),却不校验存入的参数内容、返回状态码或异常时的回滚行为。
  • 脆弱 E2E 脚本:在 Playwright 中写 div > div:nth-child(4) > button 配合 await page.waitForTimeout(3000),样式微调就报错,CI 环境稍慢就偶发超时。

要把这些问题堵在源头,除了在仓库 AGENTS.md 固化测试规范(读取机制见 /guides/codex-agents-md-how-it-reads),更要在每次生成测试的提示词里写清「允许隔离谁、必须实际验证什么」。基础跑测方法可参考 /guides/codex-write-tests-and-run。

二、高价值单元测试与 Playwright E2E 提示词模板

1. 单元测试补全模板(Vitest / Jest / pytest 通用思路)

text
请先阅读 src/services/couponService.ts 及其已有测试风格(tests/services/orderService.test.ts),再为 couponService 补全缺失的单元测试。
严格约束:
1. 禁止 Mock 任何纯业务逻辑、价格计算或本服务内部辅助函数;仅允许对外部 HTTP 客户端和当前系统时间(vi.useFakeTimers)做边界隔离;
2. 优先断言可观测的业务结果(最终折后金额、扣减状态、错误码与异常消息),禁止只写 toHaveBeenCalled() 敷衍;
3. 按表驱动用例覆盖:正常叠加券、已过期券、未满门槛、并发重复核销、负值或非法金额输入;
4. 编写完成后实际运行测试命令,并汇报新增用例覆盖了哪些具体分支。

2. Playwright E2E 主流程补全模板

text
请为登录与下单结算主流程编写 Playwright E2E 用例(e2e/checkout.spec.ts),遵循以下 Playwright 官方最佳实践:
1. 优先使用 getByRole、getByLabel、getByPlaceholder 或既有 data-testid 定位元素,禁止写脆弱的深层 CSS 类名或 nth-child 路径;
2. 全部状态校验必须使用 Web-First 异步断言(如 await expect(locator).toBeVisible() / toHaveText()),严禁使用 page.waitForTimeout() 硬编码等待;
3. 每个测试用例必须独立准备或清理测试数据,确保单独运行和并发重复运行结果一致;
4. 仅针对外部第三方支付回调使用 page.route() 模拟固定响应,前端自身路由、表单校验与后端本地接口必须走真实链路;
5. 完成后运行 `npx playwright test e2e/checkout.spec.ts` 并贴出运行结果。
订阅与账号准备提示:为多个核心模块补写单测、反复调试 Playwright 用例并运行代码审查会持续占用配额(计算机制见 /guides/codex-usage-limits)。中高频研发可在本站升级 ChatGPT Pro 5x iOS 可覆盖档 或 ChatGPT Pro 5x 信用卡不可覆盖档;新账号首次开通 Codex 若遇到手机验证受阻,可查阅 Codex 注册手机验证服务。

三、最后一道滤网:破坏性反向验证(Mutation Smoke Check)

测试跑绿只是及格线,真正检验测试含金量的标准是「源码被改坏时它能不能抓到」。在把 Codex 新写的测试合并进主干前,本站建议花两分钟做一次轻量破坏性抽查:

  1. 手动或让 Codex 临时破坏一处核心逻辑:例如把满减判断 total >= 100 改成 total > 100,或故意去掉权限校验里的角色判定。
  2. 重跑刚生成的测试集:如果对应测试立刻报错失败并精准指出断言差异,说明该用例确实卡住了真实业务分支;如果测试依旧全部绿灯,就证明它是个假测试或漏了边界。
  3. 还原临时破坏并做 /review 复核:执行 git checkout -- src/ 恢复源码,再跑一次全绿确认,并用本地 /review 检查测试文件是否存在过度打桩(用法见 /guides/codex-code-review)。

Codex 补全测试后的六项反假测检查清单

图:本站结合测试质量工程实践整理的验收示意图

常见问题

问:项目代码高度耦合外部数据库,不 Mock 数据库根本跑不起单元测试怎么办?

答:建议区分测试层级:把纯业务规则抽出来写零 Mock 的快速单元测试;涉及 SQL 查询、事务和约束的仓储层,优先使用本地容器(如 Docker 测试库 / Testcontainers)或隔离测试 Schema 跑集成测试,不要用把整套 ORM 客户端打桩的方式假装测了 SQL。

问:Playwright 用例在本地跑全绿,推到 CI 流水线却偶尔报元素点击超时怎么办?

答:常见原因有三点:一是测试之间共享了同一账号或脏数据,并发执行相互干扰;二是点击按钮前接口数据尚未渲染完毕,应先 await expect(button).toBeEnabled() 或等待对应网络响应完成;三是开启 Playwright 的 trace: 'on-first-retry' 配置,让 CI 在首次失败重试时自动留存 Trace 轨迹供 Codex 排查。

问:国内没有外币信用卡,或研发团队需要统一采购并开具增值税发票,怎么开通 ChatGPT / Codex 订阅?

答:可通过本站 AI 会员充值总览 按需选购 ChatGPT Plus、ChatGPT Plus 自助卡密 或高配额 ChatGPT Pro,支持支付宝、微信支付及 AlipayHK,采用卡密自助兑换(无需交出账号密码)或客服协助,支持开具增值税发票;多人研发团队也可了解 Business 团队定制方案。实时价格以商品页为准,售后遵循掉订阅按剩余天数折退、封号不在质保范围规则。

相关教程

参考资料

  • OpenAI Codex 官方文档:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
  • OpenAI Codex 官方文档:Custom instructions with AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md
  • Playwright 官方文档:Best Practices — https://playwright.dev/docs/best-practices
  • Playwright 官方文档:Locators — https://playwright.dev/docs/locators

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~