Playwright 自动化稳定性实践：选择器、等待与重试的三条经验

做自动化时，脚本今天能跑、明天挂掉，90% 的原因集中在定位不稳定与等待不充分。下面三条经验来自日常维护脚本的踩坑记录。

一、优先语义化选择器

少用 nth-child / 绝对 XPath，多使用面向用户的属性：get_by_role、get_by_text、稳定的 data-testid。团队协作时把关键路径的 data-testid 当成接口契约来维护。

page.get_by_role("button", name="提交").click()

二、条件等待替代固定 sleep

固定 sleep 要么太短要么浪费。用 expect(locator).to_be_visible() 或 wait_for_load_state("networkidle") 表达真实条件，超时时间按业务最慢路径设置。

三、幂等与重试

把每个步骤设计成可重复执行：操作前先判断目标状态，操作后校验结果；重试时只重跑失败步骤。日志里记录每步耗时，方便区分“慢”和“挂”。

最后，把不稳定用例单独打标并每日统计失败率，持续清理 flaky 用例比“加大超时”有效得多。