本文详解 selenium 中定位 iframe 内嵌元素的关键步骤：先切换至 iframe 上下文，再使用显式等待精准查找目标元素，避免因未切换上下文或过早查找导致的 `nosuchelementexception`。
在使用 Selenium 自动化测试网页时，一个常见却容易被忽视的陷阱是：目标元素位于 。此时，即使 XPath 或 CSS 选择器完全正确，直接调用 find_element() 也会失败——因为 Selenium 默认只在主文档（top-level document）中搜索，无法“穿透”到 iframe 的独立 DOM 上下文中。
以您提供的 Tinkoff Compass 页面为例，电话输入框（）实际嵌套在 iframe 内。原始代码未做 iframe 切换，因此 driver.find_element(By.XPATH, “//[@automation-id=’phone-input’]”) 必然抛出异常。
✅ 正确做法分三步：
-
定位并切换至 iframe
使用 driver.switch_to.frame() 切入目标 iframe。推荐通过 CSS_SELECTOR（如 “iframe”）或更稳定的属性（如 name、id）定位 iframe 元素。注意：若页面含多个 iframe，请确保选择唯一且加载完成的 iframe。 -
在 iframe 内执行操作（需显式等待）
切换后，所有后续 find_element 均作用于 iframe 的 DOM。务必搭配 WebDriverWait + expected_conditions（如 presence_of_element_located），避免因 iframe 加载延迟导致查找失败。 -
操作完成后切回主文档（如需继续操作外部元素）
调用 driver.switch_to.default_content() 返回顶层上下文，否则后续对主页面元素的操作将失效。
以下是优化后的完整示例代码（已适配最新 Selenium 4+ 语法）：
