自动化测试 / 系统课时
理解页面同步问题
理解页面同步问题
Selenium 失败并不一定是定位器写错了;更常见的情况是测试代码已经执行到下一步,而页面仍在异步更新。学会区分“页面加载完成”“元素进入 DOM”和“元素真正可操作”,就能先判断失败属于同步问题,再选择合适的等待条件。
学习目标
- 解释 WebDriver 与页面异步更新之间为什么会出现竞态。
- 根据失败现象判断应该等待页面、元素还是业务状态。
- 用一个可运行示例复现“页面已完成但元素尚未出现”的问题。
页面完成不代表业务状态就绪
默认页面加载策略为 normal 时,导航通常会等到文档达到 readyState=complete 再把控制权交还给测试代码。但这个状态只说明当前文档及其加载流程达到完成点,JavaScript 仍可能继续发请求、启动定时任务或重新渲染组件,因此目标元素可能还不存在。

下面的示例不依赖外部网站。页面先加载一个空容器,随后由脚本在 1.5 秒后插入按钮,因此可以稳定复现“文档已完成、按钮未出现”的窗口。
import time
from urllib.parse import quote
from selenium import webdriver
from selenium.common.exceptions import NoSuchElementException
from selenium.webdriver.common.by import By
html = "<!doctype html><html><body><div id='app'></div></body></html>"
url = "data:text/html;charset=utf-8," + quote(html)
driver = webdriver.Chrome()
try:
driver.get(url)
driver.execute_script(
"setTimeout(() => {"
"const b = document.createElement('button');"
"b.id = 'save-btn'; b.textContent = 'Save';"
"document.querySelector('#app').appendChild(b);"
"}, 1500);"
)
print("readyState:", driver.execute_script("return document.readyState"))
try:
driver.find_element(By.ID, "save-btn")
print("immediate lookup: found")
except NoSuchElementException:
print("immediate lookup: not ready")
time.sleep(2)
print("after 2s:", driver.find_element(By.ID, "save-btn").text)
finally:
driver.quit()预期输出:
readyState: complete
immediate lookup: not ready
after 2s: Save这个结果证明失败点不在 By.ID。第一次查找发生在 DOM 变更之前,所以默认 0 秒的元素查找等待会立即抛出 NoSuchElementException;两秒后使用同一个定位器即可成功。
先判断究竟要等什么
同步控制应围绕“下一条命令真正依赖的条件”展开,而不是统一等待固定秒数。实际排查时,可以把失败按下面几类归位,再决定后续使用隐式等待还是显式条件等待。
| 现象 | 真正缺少的条件 | 可检查的信号 |
|---|---|---|
NoSuchElementException |
元素尚未进入 DOM | 同一定位器稍后能找到元素 |
| 元素已找到但不可见 | 样式或动画尚未结束 | is_displayed() 仍为 False |
| 元素可见但操作失败 | 遮罩、禁用状态或重渲染未结束 | is_enabled()、页面遮罩与 DOM 是否变化 |
| 文本仍是旧值 | 后台请求或前端状态尚未回写 | text、value 或业务属性尚未达到目标值 |
| 旧元素突然失效 | 框架重建了节点 | 再次定位后能获得新的元素引用 |
例如“点击保存后等待按钮出现”和“点击保存后等待提示文字变成 Saved”不是同一个条件。前者只关心节点是否存在,后者关心业务状态是否已更新;即使按钮早已在 DOM 中,也不能证明保存流程完成。
固定休眠只适合复现,不适合长期同步
time.sleep(2) 会无条件暂停两秒:页面 100 毫秒就准备好时仍然浪费剩余时间,页面需要 2.5 秒时又会失败。它适合像上面的教学示例那样制造清晰时间窗口,或临时验证“多等一会儿是否能通过”,不适合作为稳定测试的默认方案。
排查同步问题时,先记录触发动作、失败命令和真正需要满足的状态。若只是元素“稍晚出现”,可以用下一课的隐式等待覆盖元素查找;若需要等待可见、可点击、文本变化或遮罩消失,则应使用针对条件的等待,而不是继续增加固定休眠时间。