必须逐层 switch_to.frame() 进入并用 parent_frame() 或 default_content() 退出，否则元素定位静默失败；iframe 切换失败主因是未切换上下文导致内部 DOM 不可见，参数应优先选用 WebElement 对象，嵌套时需手动管理栈式上下文。
必须逐层 switch_to.frame() 进入，再用 switch_to.parent_frame() 或 switch_to.default_content() 退出；漏掉任何一层切换，后续所有元素定位都会静默失败。
iframe 切换失败的典型表现和根本原因
页面明明有 <iframe>，但 find_element(By.XPATH, "...") 报 NoSuchElementException；click() 没反应；send_keys() 输不进内容。这不是选择器写错了，而是 Selenium 默认只在顶层 document 上下文操作，iframe 内部是独立 DOM，不切换就完全不可见。
三种 switch_to.frame() 参数怎么选
传错参数是切换失败的最常见原因：
- 用字符串（如
"myFrame"）：要求 iframe 标签同时含id="myFrame"或name="myFrame"；若两者都有，name优先匹配 - 用数字索引（如
0）：按 DOM 中<iframe>出现顺序从 0 开始计数；页面结构一变就失效，仅适合调试或单层固定场景 - 用 WebElement 对象（推荐）：先
find_element(By.ID, "inner-frame")找到元素，再传给switch_to.frame()；动态 iframe、id/name 不稳定时唯一可靠方式
注意：switch_to.frame() 不接受 CSS 选择器或 XPath 字符串，必须先查出元素对象再传。
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
嵌套 iframe 必须手动管理上下文栈
Selenium 的 iframe 上下文是栈式结构，不是自动感知的：
- 进一层：
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() 是高频错误——后续所有定位都跑偏，但报错信息往往和 iframe 完全无关，容易误判为元素没加载或 selector 错了。
为什么切进去了还是操作不了元素
切换成功 ≠ 元素就绪。常见干扰项：
-
src是延迟加载的（比如初始为about:blank），得等真实 URL 加载完成 + 子文档readyState === 'complete'，用WebDriverWait等frame_to_be_available_and_switch_to_it或自定义条件 - 跨域 iframe（如第三方登录框、广告）会被浏览器沙箱阻断，
switch_to.frame()可能静默失败或抛InvalidFrameContextException - iframe 内部还有 Shadow DOM：Selenium 4+ 支持，但得先用
shadow_root查找，不能直接find_element
真正难处理的从来不是“怎么进”，而是“什么时候才算真正可操作”——DOM 加载、JS 渲染、跨域限制、Shadow DOM，每一层都可能卡住。
