Playwright为什么老是跑不稳？12个坑踩完我终于懂了！

周五傍晚，理想的状态是测试报告全绿、CI顺利完成、泡杯咖啡享受下班时光。

如果你的 Playwright 测试套件老是慢、莫名失败、生成一堆无用截图，那说明你的测试实践还有提升空间。下面这 12 条，结合实战经验和落地方法，帮你把“周五发版提心吊胆”变成“放心发版”。

1）按风险与业务流程划分用例，而非死堆模块

把测试当成风险网，而不是功能文档。

• 高风险链路（登录、下单、支付）快速覆盖、严格断言
• 次要视觉或边界用例夜间或发版前全量回归

落地： 用标签（@critical / @regression）或不同集合，PR 提交只跑 @critical，发版前跑 @regression，既保证快速反馈，又覆盖全量风险。

2）稳定的定位策略：优先 data-test 或 role / class

定位器不稳定是测试不稳定的罪魁祸首。

• 优先使用 data-test / data-testid
• 如果暂时不可用，可选择稳定的 class 或 role 属性
• 避免基于文本或深层 CSS 的脆弱选择器

落地： 核心元素加测试 ID，PR/Lint 检查 enforce 规范。

3）放弃固定 sleep，靠明确信号同步

waitForTimeout 是“坏味道”，会增加测试抖动。

• 优先等待网络完成、元素可见或路由稳定
• 使用 Playwright 自动等待和 web-first 断言

示例：

await page.waitForResponse(resp => resp.url().includes('/api/orders') && resp.status() === 200);
await expect(page.locator('#submit')).toBeVisible();

4）把登录和共有状态放入 fixtures / storageState

重复登录既慢又易出错。

• 用 storageState 或 fixtures 保存登录态
• 测试启动即加载登录状态，快速、稳定、可靠

落地： setup 脚本生成 auth.json，测试启动时加载 context.addCookies() 或 storageState。

5）测试数据优先通过 API 或后端接口准备

UI 流程慢、脆弱。

• 数据准备和清理通过 API 完成
• UI 只做端到端验证或展示验证

落地： CI 阶段调用 /api/test/setup 初始化数据，测试结束 /api/test/teardown 清理，保证每次运行环境可控。

6）Mock 外部依赖，保留少量真实监控

第三方服务（支付、短信、地图）可能导致随机失败。

• 用 HAR 回放或 route/stub 固定响应
• 只保留少量真实调用做 Canary 监控

落地： CI 中 mock 不可控接口，单独一组真实环境做稳定性监控。

7）视觉回归需精细化

视觉回归容易产生噪音：

• 动态区域（时间戳、广告位、头像）用 mask
• 核心组件设置严格阈值，非核心用宽松阈值

落地： 先从核心页面开始，小范围验证，再逐步扩大覆盖。

8）Trace / 视频按需开启

Trace 和视频在失败时极其有用，但全程开启会拖慢测试。

• 按测试或失败条件动态开启
• CI 默认关闭 trace，但失败时自动启用

落地： 失败 artifact 上传 trace 或视频，方便快速定位。

9）合理设置并发与 worker 数

并发并非越高越好。

• 先 profile 测试 suite，找出瓶颈（CPU、DB、网络）
• worker 数量结合系统资源和 suite 特性调整

落地： 调整并发时观察整体耗时和资源占用，避免盲目加 worker。

10）倾向“业务剧本式”辅助函数

传统 Page Object 易膨胀难维护。

• 将复杂业务流程拆成可复用的步骤函数
• 测试代码读起来像业务故事

示例：

await auth.loginAs(user);
await cart.addItem(item);
await checkout.placeOrder();

11）让不稳定用例可见、可追踪

Flaky 测试应被量化和隔离，而非无限重试。

• 统计每个 spec 失败率
• 超过阈值标注、隔离并创建修复任务

落地： CI 输出失败率报表，高失败率用 test.skip 或 test.fixme，并跟踪 issue。

12）报告标准化，关键信息一目了然

截图、trace、网络请求是定位问题关键线索。

• 命名标准化，方便快速定位
• CI artifact 暴露 HTML 报告和 trace

落地： 截图命名示例：specName--step--timestamp，报告可以点击直接查看失败详情。

写在后面

Playwright 不只是工具，而是一套工程化方法：

• 按业务风险划分用例
• 测试数据可控、环境稳定
• 定位器稳健、并发合理
• Trace、截图、网络请求标准化管理

只要逐条优化，测试流程焦虑感会逐渐消失，发版不再提心吊胆。