自动化测试 / 系统课时
处理窗口切换失败
处理窗口切换失败
窗口切换失败通常不是 switch_to.window() 本身失效,而是句柄还没出现、目标窗口已关闭,或测试仍在错误的浏览上下文里。本课用可复现的双窗口示例建立排查顺序:先保存旧句柄,再等待新句柄出现,用集合差找目标,关闭后显式切回,并在失败时记录当前句柄集合。
学习目标
- 区分“新窗口尚未出现”“句柄已失效”和“上下文切错”三类故障。
- 用显式等待与句柄差集可靠定位新窗口,而不是依赖固定下标。
- 在窗口关闭后恢复到仍存活的句柄,并排除 iframe、弹窗导致的假性窗口问题。
先按句柄生命周期定位故障
排查时先记录点击前后的 driver.window_handles 与 driver.current_window_handle。如果点击后句柄数量一直不增加,优先检查点击是否成功、浏览器是否阻止新窗口以及页面是否异步创建窗口;如果句柄曾出现但切换时报 NoSuchWindowException,说明目标可能已在读取句柄后被关闭。
关闭当前窗口后必须显式切换到另一个有效句柄再继续操作。Selenium 不会因为 driver.close() 自动恢复到原窗口;继续在已经关闭的上下文执行命令,典型结果就是 NoSuchWindowException。

用句柄差集完成可靠切换
不要把“第二个窗口”长期写成 driver.window_handles[1]。当测试夹具、认证流程或扩展额外打开窗口时,下标会失去业务含义。更稳的做法是点击前保存句柄集合,等待集合增加,再用差集找出本次新出现的句柄。
import threading
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from selenium import webdriver
from selenium.common.exceptions import NoSuchWindowException
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path == "/child":
page = b"<title>Child</title><p>child window</p>"
else:
page = (
b"<title>Parent</title>"
b'<a id="open" href="/child" target="_blank">Open child</a>'
)
self.send_response(200)
self.send_header("Content-Type", "text/html; charset=utf-8")
self.send_header("Content-Length", str(len(page)))
self.end_headers()
self.wfile.write(page)
def log_message(self, format, *args):
pass
server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)
threading.Thread(target=server.serve_forever, daemon=True).start()
driver = None
try:
driver = webdriver.Chrome()
wait = WebDriverWait(driver, 10)
driver.get(f"http://127.0.0.1:{server.server_port}/")
original = driver.current_window_handle
before = set(driver.window_handles)
driver.find_element(By.ID, "open").click()
# 等待本次操作真正产生新句柄,而不是立即读取旧列表。
wait.until(lambda d: len(set(d.window_handles) - before) == 1)
new_handle = (set(driver.window_handles) - before).pop()
try:
driver.switch_to.window(new_handle)
except NoSuchWindowException as exc:
raise AssertionError(
f"target vanished; remaining={driver.window_handles}"
) from exc
print(f"child_title={driver.title}")
driver.close()
if original not in driver.window_handles:
raise AssertionError(
f"original window vanished; remaining={driver.window_handles}"
)
driver.switch_to.window(original)
print(f"back_title={driver.title}")
finally:
if driver is not None:
driver.quit()
server.shutdown()
server.server_close()预期输出:
child_title=Child
back_title=Parent这个示例把最常见的竞态压缩到一个位置:只有检测到“新句柄集合恰好多 1 个”才继续。如果业务一次可能打开多个窗口,不要直接 pop();应逐个切换候选句柄并用标题、URL 或页面中的稳定标识确认目标。
关闭窗口后先验证幸存句柄
发生异常时,不要继续复用几分钟前缓存的目标句柄。先重新读取 driver.window_handles:目标句柄不在集合中,就视为已失效;原窗口仍在集合中,才执行 driver.switch_to.window(original)。若集合为空,说明已经没有可切换的顶层窗口,应结束当前 WebDriver 会话而不是继续重试。
推荐把失败现场至少记录四项:当前句柄、全部句柄、当前 URL、当前标题。句柄值本身是会话内的不透明标识,不要把它写死进测试数据,也不要假设跨会话相同。
排除窗口之外的上下文错误
切到正确窗口后仍然找不到元素,不代表窗口切换又失败。先用 driver.title 或 driver.current_url 确认顶层窗口正确;如果元素位于 iframe,还需要 driver.switch_to.frame(...),完成后用 driver.switch_to.default_content() 回到顶层文档。若页面出现 JavaScript alert,则应通过 driver.switch_to.alert 处理,它不是窗口句柄。
另一个常见问题是复用旧窗口里已经定位过的 WebElement。页面导航、DOM 重建、切换窗口或 frame 后,这个元素引用可能变成 stale;回到目标上下文后应重新用定位器查找元素,而不是把旧 WebElement 对象跨窗口长期保存。