在 Web 自动化测试里，iframe 是最容易让脚本失效的结构之一。浏览器把 iframe 视作独立文档，Selenium 的 WebDriver 对象默认只认顶层页面，因此直接查找 iframe 里面的按钮或输入框会抛出 NoSuchElementException。要解决这个问题，核心在于切换驱动的作用域，把上下文移动到目标 iframe 内部，等完成内部操作后再切回原文档。
理解 iframe 隔离机制与切换原理
从浏览器渲染角度看，每一个 <iframe> 标签都会创建一个全新的浏览上下文，拥有自己的 DOM 树和 Window 对象。Selenium 的 WebDriver 在初始化时，只持有顶层页面的执行环境引用。当你调用 find_element 时，命令被发往当前活动上下文，而该上下文并不知道 iframe 里的节点存在，自然返回找不到元素。
切换上下文依靠 driver.switch_to.frame() 方法。它通知浏览器把 WebDriver 的当前文档指针指向指定 iframe 的 contentDocument。此时所有后续定位都在 iframe 内执行。需要特别注意的是，切换是单向堆叠的：如果页面有三层 iframe 嵌套，你必须按顺序一层层切进去；返回时可用 switch_to.parent_frame() 回退一层，或用 switch_to.default_content() 直接回到最外层。
很多新手误以为切换 iframe 后原页面元素就不可用了，其实只是作用域变了。如果用例既要操作外层表单又要填内层内容，就需要在两者间反复切换。下面代码展示基础切换逻辑：
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://ipipp.com/demo")
# 通过 id 切入
driver.switch_to.frame("login_frame")
driver.find_element("id", "username").send_keys("test")
# 回到顶层
driver.switch_to.default_content()
四种切入方式与稳定性对比
Selenium 提供四种参数形式来定位 iframe：字符串（id 或 name）、整数索引、WebElement 对象、以及 Selenium 4 的 Locator 对象。用 id 或 name 最直观，但不少前端框架会生成动态 id，例如 iframe_12345，每次刷新都变，脚本极易断裂。索引方式按出现顺序填 0、1、2，可应对无标识的 iframe，但页面结构一调整顺序就全错。
最稳妥的是先正常定位 <iframe> 元素本身，再把该 WebElement 传给 switch_to.frame()。这样完全不依赖属性值，也不关心位置。示例先用 XPath 找到带特定 title 的 iframe，再切入，能抗住大部分重构：
frame_elem = driver.find_element("xpath", "//iframe[@title='支付组件']")
driver.switch_to.frame(frame_elem)
pay_btn = driver.find_element("css selector", ".pay-now")
pay_btn.click()
driver.switch_to.default_content()
下表列出不同方式在常见场景下的表现：
| 切入方式 | 适用场景 | 脆弱点 |
|---|---|---|
| id/name | 静态标识 | 动态生成时失效 |
| 索引 | 无属性iframe | 顺序变化即错 |
| WebElement | 复杂现代前端 | 需先能定位iframe |
等待加载与多层嵌套实战
iframe 往往是异步加载的，页面主文档好了但 iframe 还没拉回内容。如果切得太早，即便作用域对了也会找不到内部节点。正确做法是用 WebDriverWait 等 iframe 元素可见且可切，再执行切换。对于嵌套结构，要写清晰的顺序切换代码，并配合异常处理防止中间层缺失导致整体报错。
下面例子演示等待并切入二层 iframe：先等外层 iframe 出现，切进去后再等内层 iframe，最后操作按钮。任何一步超时就捕获并打印上下文，便于排查是网络慢还是选择器错。
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 10)
outer = wait.until(EC.presence_of_element_located(("id", "wrap")))
driver.switch_to.frame(outer)
inner = wait.until(EC.presence_of_element_located(("tag name", "iframe")))
driver.switch_to.frame(inner)
wait.until(EC.element_to_be_clickable(("id", "submit"))).click()
跨域 iframe 受浏览器同源策略限制，Selenium 能切入但无法读取其内部 DOM，此时只能做整体交互不能细查元素。若测试系统允许，可改用无头浏览器插件或协调开发开放同源，否则应将断言放在父页通信上，而不是强行读取内部文本。