别再写 try/except 了——给浏览器自动化加一层"自动愈合"的稳定层

「工程化实战」栏目 第 02 篇

与周一《从 IP 到 Browser Context》的关系：周一讲的是环境隔离（L1/L2/L3 指纹），这篇讲的是脚本自身的健壮性——环境隔离好了，脚本本身还是会因为元素抖动、加载时序、偶发超时而挂。这篇给的是架构级答案。

导读

如果你的浏览器自动化脚本里到处都是这样的代码：

try:page.click("#submit")except:try:page.click(".btn-primary")except:try:page.click("text=提交")except:page.screenshot(path="error.png")raise

是时候停下来想想了。

这不是工程，这是用 try/except 堆出来的补丁。每加一个 except 就多一层脆弱性，每多一个嵌套就多一个"不知道为什么挂了"的盲区。

本文给出一个架构级方案——自动愈合层：让脚本在元素抖动、加载时序偏移、偶发超时的时候，自己修复自己，而不是直接报错。三个组件：Selector 重试、状态 fallback、截图证据链。一套 BasePage 模板 + pytest 集成，看完直接搬进项目。

关键词：Playwright 自动愈合、自动化测试稳定性、Selector 重试策略、BasePage 模板、pytest 浏览器自动化、截图证据链、元素定位失败重试、自动化测试架构

一、问题拆解：脚本为什么会"偶发失败"

在讲方案之前，先把"偶发失败"拆成三类。不同类型的失败，修法完全不同：

try/except 的问题在于：它把这三类失败混为一谈，统一用"抓异常 → 换 selector → 再试"来兜底，既不区分原因，也不记录现场。出了问题回头看日志，只有一句TimeoutError，啥也分析不了。

二、什么是"自动愈合"层

自动愈合的核心思想：脚本遇到问题时，先尝试自己修复，修复失败才报错——并且报错时带上完整的现场证据。

三个组件各管一类失败：

┌─────────────────────────────────────────┐ │ 自动愈合层 (AutoHeal) │ │ │ │ ┌──────────────┐ ┌────────────────┐ │ │ │ Selector 重试 │ │ 状态 Fallback │ │ │ │ (解决 A 类) │ │ (解决 B 类) │ │ │ └──────┬───────┘ └───────┬────────┘ │ │ │ │ │ │ └────────┬─────────┘ │ │ │ │ │ ┌────────▼─────────┐ │ │ │ 截图证据链 │ │ │ │ (解决 C 类 + 排障) │ │ │ └──────────────────┘ │ └─────────────────────────────────────────┘

• Selector 重试：一个元素配多个 selector，第一个不行自动换第二个
• 状态 fallback：不靠time.sleep()等时间，而是等页面达到某个可观测状态
• 截图证据链：每次操作前后自动截图，失败时自动保存完整的操作序列

三、代码实现

代码 1：Selector 策略管理器

先定义一个 Selector 策略——每个元素配多个定位方式，按优先级排序：

fromdataclassesimportdataclass,fieldfromtypingimportListfromplaywright.sync_apiimportPage,Locator@dataclassclassSelectorStrategy:"""元素的多元 selector 策略"""name:str# 元素名称（用于日志）selectors:List[str]# 多个 selector，按优先级排序description:str=""# 人可读的描述deffind(self,page:Page,timeout:int=10000)->Locator:"""按优先级尝试每个 selector，返回第一个找到的"""last_error=Nonefori,selinenumerate(self.selectors):try:locator=page.locator(sel)# 等元素出现，但不等它可交互（那是上层的事）locator.wait_for(state="visible",timeout=timeout)returnlocatorexceptExceptionase:last_error=eprint(f"[SelectorStrategy] '{self.name}' "f"selector #{i+1}'{sel}' 失败:{e}")raiseRuntimeError(f"元素 '{self.name}' 所有 selector 均失败。"f"尝试了:{self.selectors}。最后错误:{last_error}")# --- 定义页面的元素策略 ---SUBMIT_BTN=SelectorStrategy(name="提交按钮",selectors=["#submit-btn",# 最稳：ID"button[type='submit']",# 次选：属性".btn-primary >> text=提交",# 兜底：文本"role=button[name='提交']",# 最后：无障碍角色],description="购物车页面的提交按钮，4 种定位方式")

关键设计：selector 从最精确的（ID）到最模糊的（角色/文本），按优先级降级。这样即使页面改版改了 ID，脚本也能用兜底 selector 继续跑。

代码 2：BasePage 基类（含自愈 click / fill / wait）

importosfromdatetimeimportdatetimefrompathlibimportPathfromplaywright.sync_apiimportPage,LocatorclassBasePage:"""所有页面对象的基类，内置自动愈合能力"""def__init__(self,page:Page,screenshot_dir:str="screenshots"):self.page=page self.screenshot_dir=Path(screenshot_dir)self.screenshot_dir.mkdir(parents=True,exist_ok=True)self._action_count=0# 操作计数，用于截图命名defheal_click(self,strategy:SelectorStrategy,timeout:int=10000)->None:"""自愈点击：多 selector 降级 + 前后截图"""self._before_action(strategy,"click")locator=strategy.find(self.page,timeout=timeout)# 等元素可交互（不只是 visible，还要 enabled）locator.wait_for(state="visible",timeout=timeout)# 检查元素状态ifnotlocator.is_enabled():raiseRuntimeError(f"元素 '{strategy.name}' 可见但不可点击（disabled）")locator.click()self._after_action(strategy,"click")defheal_fill(self,strategy:SelectorStrategy,text:str,timeout:int=10000)->None:"""自愈填充：多 selector 降级 + 前后截图"""self._before_action(strategy,f"fill('{text}')")locator=strategy.find(self.page,timeout=timeout)locator.wait_for(state="visible",timeout=timeout)# 先清空再填，避免追加locator.fill("")locator.fill(text)self._after_action(strategy,f"fill('{text}')")defwait_for_state(self,strategy:SelectorStrategy,state:str="visible",timeout:int=15000)->None:""" 状态 fallback：等元素达到某个状态，而不是 sleep 固定时间。 state 可选: "attached" | "detached" | "visible" | "hidden" """print(f"[BasePage] 等待 '{strategy.name}' 状态={state}")locator=strategy.find(self.page,timeout=timeout)locator.wait_for(state=state,timeout=timeout)# ---- 截图证据链 ----def_before_action(self,strategy:SelectorStrategy,action:str)->None:"""操作前截图"""self._action_count+=1ts=datetime.now().strftime("%H%M%S_%f")path=self.screenshot_dir/f"{self._action_count:03d}_{strategy.name}_{action}_BEFORE_{ts}.png"try:self.page.screenshot(path=str(path))print(f"[证据链] 操作前截图:{path}")exceptExceptionase:print(f"[证据链] 截图失败（不影响主流程）:{e}")def_after_action(self,strategy:SelectorStrategy,action:str)->None:"""操作后截图"""ts=datetime.now().strftime("%H%M%S_%f")path=self.screenshot_dir/f"{self._action_count:03d}_{strategy.name}_{action}_AFTER_{ts}.png"try:self.page.screenshot(path=str(path))print(f"[证据链] 操作后截图:{path}")exceptExceptionase:print(f"[证据链] 截图失败（不影响主流程）:{e}")

关键设计：

1. heal_click/heal_fill接收的是SelectorStrategy而不是字符串——强制你为每个元素定义多元 selector，从根源上消除"selector 写死"的脆弱性
2. 操作前后各截一张图，形成证据链——失败时可以按序号回放
3. wait_for_state等的是状态（visible / detached），不是时间——解决 B 类时序偏移问题
4. 截图失败不影响主流程（try/except只用在截图上，不用在业务逻辑上）

代码 3：pytest 集成 + 自动重跑

importpytestfromplaywright.sync_apiimportsync_playwrightfrompages.base_pageimportBasePagefrompages.selectorsimportSUBMIT_BTN,USERNAME_INPUT,PASSWORD_INPUTclassTestLoginPage(BasePage):"""登录页测试——继承 BasePage，自带自愈能力"""@pytest.fixture(autouse=True)defsetup_page(self):withsync_playwright()asp:browser=p.chromium.launch(headless=True)# 周一那篇讲的：用 new_context 隔离环境context=browser.new_context(viewport={"width":1920,"height":1080},locale="zh-CN",)self.page=context.new_page()# BasePage 初始化（带截图目录）super().__init__(self.page,screenshot_dir="screenshots/login_test")self.page.goto("https://example.com/login")yieldcontext.close()browser.close()deftest_login_success(self):"""用自愈方法跑登录流程"""# 填用户名——即使页面改了 ID，兜底 selector 也能找到self.heal_fill(USERNAME_INPUT,"test_user")self.heal_fill(PASSWORD_INPUT,"test_pass")# 等提交按钮可交互（状态 fallback，不 sleep）self.wait_for_state(SUBMIT_BTN,state="visible")self.heal_click(SUBMIT_BTN)# 验证登录成功——同样用多元 selectorself.wait_for_state(SelectorStrategy(name="仪表盘",selectors=[".dashboard","#main-content","text=欢迎"],),state="visible",timeout=20000,)# ---- pytest 自动重跑配置（conftest.py）----# 在项目根目录的 conftest.py 里加：## import pytest## @pytest.fixture(scope="session")# def rerun_config():# return {"reruns": 2, "reruns_delay": 3}## # 命令行运行时加 --reruns 2 --reruns-delay 3# # 需要 pip install pytest-rerunfailures

与 pytest 集成的好处：

1. pytest-rerunfailures插件提供自动重跑——C 类偶发超时自动重试 2 次，不需要在代码里写 retry 逻辑
2. 截图证据链和 pytest 的tmp_path/ HTML 报告天然兼容
3. 每个测试类继承BasePage，所有自愈能力开箱即用

四、效果对比

五、与周一文章的串联

周一《从 IP 到 Browser Context》讲的是环境隔离——让脚本跑在干净的 Browser Context 里，不被其他任务干扰。

这篇讲的是脚本自愈——让脚本在环境已经隔离好的前提下，依然能应对元素抖动和时序偏移。

两者解决的是不同层次的问题：

第一层（周一）：环境隔离 → 让脚本跑在干净环境里 第二层（本周）：脚本自愈 → 让脚本在干净环境里也不容易挂 第三层（周五预告）：环境指纹锁定 → 让 CI 环境和本地环境一致

如果你只看了周一那篇，这篇的增量是：环境隔离解决的是"外部干扰"，自愈层解决的是"脚本自身的脆弱性"——两者叠加，才是工程化的稳定方案。

六、小结

三件事，记住就够：

1. 别再裸写 try/except——用SelectorStrategy为每个元素配多元 selector，自动降级
2. 别再 sleep——用wait_for_state等状态，不等活动时间
3. 别再裸跑——用pytest-rerunfailures自动重跑 + 截图证据链排障

把这三件事做到，你的浏览器自动化脚本通过率从 92% 提到 99%+，不是什么难事。

「工程化实战」栏目 第 02 篇

关注「浏览器自动化实战」，每周一到两篇从"踩坑"升级到"工程化"的实战内容。

下一篇预告：《Playwright vs Selenium 4 vs Puppeteer：在 2026 年，浏览器自动化该选谁？》（周四发，工具横评栏目）

如果这篇对你有用，点个「在看」和「收藏」——这是本栏目的主力留粉篇，你的收藏是我判断内容方向的重要信号。

本文同步发布于公众号「浏览器自动化实战」、知乎、CSDN。代码均已在本地 Playwright 1.40+ (Python) + pytest 8.x 跑通验证。依赖：pip install playwright pytest pytest-rerunfailures