自动化脚本总要多等几秒?把固定休眠改成有条件的等待

用明确的成功条件、失败条件和截止时间设计等待;分开可操作检查与结果验收,避免脚本抢跑、重复提交或无限等待。

把“等三秒再点”改成“等到可验证的条件成立,超过上限就停”,通常比不断加长休眠更值得先做。 关键不是删掉所有延时,而是说清楚:这一刻究竟在等什么,凭什么继续,失败后留下什么。

本文依据 2026 年 9 月 15 日核对的 Selenium、Playwright 官方文档讨论脚本设计。文中的流程是示例,不是可直接粘贴到任意手机自动化工具的接口代码,也没有进行设备实测。

三秒只是时间,不是页面状态

Selenium 文档指出,固定休眠太短可能赶不上页面,太长则拖慢整个会话;显式等待会检查具体条件,并在超时前满足条件时继续。这与每次无论快慢都睡满相同时间不同。Selenium 等待策略

例如,要读取搜索结果,真正想等的不是“三秒过去”,而是“这一轮查询的结果或明确的空结果已经出现”。如果一直等列表非空,合法的零结果反而会被当成故障。

给每个等待写一张小卡片

下面是一组虚构的搜索流程条件,可按自己的页面改写:

项目 应写清的内容
当前动作 已提交一次查询,不在等待循环里重复提交
成功条件 当前查询对应的结果区域更新,或出现明确的空结果状态
失败条件 出现登录失效、无权限或服务错误
时间预算 例如最多 8 秒,仅为示例,需按实际任务调整
超时证据 最后看到的页面、条件名称、耗时与错误,不保存敏感业务内容

“加载动画消失”单独作为成功条件仍然不够:错误页也可能没有动画。建议同时确认目标页面身份与本次结果的关联,避免读到上一轮残留内容。

看得到按钮,和能点按钮不同

Playwright 的点击检查不仅包括目标可见,还包括稳定、启用和能够接收事件。这个区别很实用:按钮即使在画面里,也可能还在移动或被遮挡。Playwright 可操作性检查

因此,使用具备元素检查能力的框架时,优先使用它已有的等待机制。只有截图或坐标能力时,也应检查目标区域和页面上下文;但不要把“识别到一块像按钮的图”描述成已经验证了全部可操作条件。

操作前等条件,操作后验结果

准备好点击,不代表点击后的业务已经完成。Playwright 的自动重试断言会重新检查预期状态,直至满足条件或达到断言超时;异步断言需要正确等待。Playwright 断言文档

可以按下面的伪流程组织。它表达的是设计,不属于任何产品 SDK:

等待本页查询控件可操作,受步骤截止时间约束
提交一次查询
重复只读检查:
    若出现明确错误:记录并停止
    若本次结果或空结果成立:记录结果并结束
    若达到截止时间:记录最后状态并停止
    按合理间隔等待,再检查

这里重试的是“查看状态”,不是“再次点击提交”。把有副作用的动作放进重试循环前,要先明确重复执行的风险与防重办法。

别让等待本身变成新负担

以下是实现建议,而非统一的最佳参数:

  • 给每次状态读取也设超时,不能外层写了 8 秒,内层一次请求却一直不返回。
  • 不要每轮重新获得完整截图、全部元素和所有日志;使用足以判断条件的最小证据。
  • 条件成立立即结束,用户取消后退出;为整个任务设置总预算。
  • 若框架已有自动等待,先了解它的时间设置。Selenium 明确提醒不要混用隐式和显式等待,以免等待时间难以预测。官方说明

验收时至少覆盖“立即就绪、稍后就绪、明确失败、一直不就绪、用户取消”五种情况。目的不是让超时永不发生,而是让脚本既不抢跑,也不会无限等下去。

参考来源