Playwright HTML报告为何显示项目超时？实际因.toPass()超时失败

核心问题拆解 #

• 首次测试耗时2.6分钟，报告同时显示两个超时提示：.toPass()配置的120000ms（2分钟）超时，以及项目配置timeout属性的900000ms（15分钟）超时
• 重试后测试通过，无法明确首次失败的根因，但数据倾向是.toPass()超时导致

问题本质解释 #

Playwright的超时机制存在层级优先级，当断言级超时（.toPass()）触发时，会直接终止当前断言执行，进而导致整个测试用例中断。此时测试报告可能会附带打印项目级的超时配置，但这并非实际触发的超时原因——项目级超时是测试的最大允许时长，而断言级超时是更早触发的终止条件。

验证与排查步骤 #

1. 明确.toPass()作用范围：.toPass()是针对单个断言的超时设置，用于等待断言条件满足，一旦超过设定时间未达标，立即抛出超时错误并终止测试
2. 匹配耗时数据：首次测试耗时2.6分钟，刚好超过.toPass()的2分钟阈值，完全符合断言超时的触发逻辑；15分钟的项目级阈值远未达到，不可能是实际触发原因
3. 结合重试结果验证：重试后通过，说明第二次执行时断言条件在2分钟内满足，未触发.toPass()超时，直接验证了首次失败是断言超时导致

优化建议 #

• 若该用户流程确实需要超过2分钟才能完成，调整.toPass()的超时值，比如设置为180000ms（3分钟），匹配实际流程耗时
• 理清超时层级优先级：断言级超时（.toPass()）> 测试用例级超时（test.setTimeout()）> 项目级超时（timeout），优先级越高越先触发终止
• 排查时优先关注断言失败的具体错误栈，而非报告底部的项目配置提示，错误栈会明确标注触发终止的超时类型

内容的提问来源于stack exchange，提问作者PixelPlex