本文详解 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+ 语法）：
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 启动浏览器（启用最大化）
options = Options()
options.add_argument("--start-maximized")
driver = webdriver.Chrome(options=options)
wait = WebDriverWait(driver, 20)
try:
driver.get("https://compass.tinkoff.ru/")
# 等待主页面关键元素出现，确认页面已加载
wait.until(EC.presence_of_element_located((By.ID, "app")))
# ✅ 步骤1：定位并切换至 iframe
iframe = wait.until(EC.presence_of_element_located((By.CSS_SELECTOR, "iframe")))
driver.switch_to.frame(iframe)
# ✅ 步骤2：在 iframe 内查找并点击地图按钮
map_btn = wait.until(EC.element_to_be_clickable((By.XPATH, "//button[.='Открыть всю карту']")))
map_btn.click()
# ✅ 步骤3：在 iframe 内查找电话输入框并输入
phone_input = wait.until(EC.element_to_be_clickable((By.XPATH, "//input[@role='textbox']")))
phone_input.clear() # 清空可能存在的默认值
phone_input.send_keys("99999999")
# ✅ 如需操作 iframe 外的元素，切回主文档
driver.switch_to.default_content()
finally:
# 可选：保持浏览器打开便于调试
pass⚠️ 注意事项：
- 避免使用 time.sleep() 替代显式等待——它不可靠且降低执行效率；
- By.XPATH 中 //[@automation-id='...'] 是无效语法（缺少标签名），应写为 //*[@automation-id='phone-input']，但本例中该属性在 iframe 内不可见，故改用 @role='textbox' 更健壮；
- 若 iframe 有 id 或 name 属性（如
- 操作 iframe 后忘记 switch_to.default_content() 是高频错误，会导致后续查找失败。
掌握 iframe 上下文切换，是 Selenium 实战中绕不开的核心技能。只要牢记「先切入、再查找、后切出」的三步原则，并始终配合显式等待，绝大多数嵌套元素定位问题都能迎刃而解。
