iframe切换失败的典型表现是页面有iframe但找不到子元素、click()无反应、send_keys()无效；根本原因是Selenium默认只操作顶层文档，需显式切换上下文。
直接操作 iframe 内的元素一定会失败，因为 WebDriver 默认只在顶层文档中查找 DOM；必须先用 switch_to.frame() 切换上下文，否则所有 find_element 都会抛 NoSuchElementException。
iframe 切换失败的典型表现有哪些
页面明明渲染出了 <iframe>，但：
– 用 find_element(By.XPATH, "//input[@id='xxx']") 找不到子元素
– 调用 click() 没反应，send_keys() 输入无效果
– 错误堆栈里完全不提 iframe，只报定位失败或超时
根本不是 selector 写错了，而是你还在主文档里“隔空打牛”。Selenium 不会自动钻进 iframe，它连子文档的存在都不知道。
switch_to.frame() 的三种参数怎么选
传错类型就切不进去，而且错误提示极其隐蔽：
立即学习“Python免费学习笔记（深入）”；
-
字符串（id 或 name）：如
driver.switch_to.frame("login-frame")。要求 iframe 标签同时含id="login-frame"或name="login-frame"；若两者都存在，name优先级更高 -
WebElement 对象：如
driver.switch_to.frame(driver.find_element(By.TAG_NAME, "iframe"))。最可靠，适合动态生成 id/name 的场景（比如广告 iframe、登录弹窗），也兼容By.CSS_SELECTOR或By.XPATH定位 -
数字索引：如
driver.switch_to.frame(0)。按 DOM 中<iframe>出现顺序从 0 开始计数，极易因前端改版失效，仅建议调试时临时用
注意：switch_to.frame() 不接受 CSS 选择器字符串或 XPath 字符串——必须先 find_element 得到对象，再传进去。
嵌套 iframe 怎么进、怎么出
iframe 可以多层嵌套，Selenium 的上下文是栈式管理的，进要一层层 switch_to.frame()，出必须手动弹栈：
- 进入第一层：
driver.switch_to.frame("outer-frame") - 在第一层内找并进入第二层：
driver.switch_to.frame(driver.find_element(By.ID, "inner-frame")) - 操作完内层后，返回上一层：
driver.switch_to.parent_frame() - 想彻底清空上下文、回到最外层：
driver.switch_to.default_content()
漏掉 parent_frame() 或 default_content() 是高频失误——后续所有操作都会静默失败，错误信息还指向别的元素，排查起来绕一大圈。
为什么切进去了还是操作不了元素
常见非切换逻辑问题：
-
src 是延迟加载的：iframe 初始
src="about:blank"，靠 JS 后续赋值真实 URL。此时需等src非空 + 子文档readyState === 'complete'，不能只等 iframe 元素出现 -
跨域 iframe：比如嵌入的第三方登录框、支付组件。浏览器会阻断 Selenium 访问其 DOM，
switch_to.frame()可能静默失败，或抛InvalidFrameContextException -
iframe 内容还没渲染完成：即使 src 已加载，子页面 JS 可能还在执行。得用
WebDriverWait等具体元素可交互，而不是只等 iframe 存在
真正难处理的是跨域和动态 src 场景——这时候切进去只是假象，实际 DOM 不可见，再多等待和重试都没用。
