当使用 selenium python 进行自动化测试时，点击一个按钮后代码可能会出现冻结，尤其是在该操作导致新窗口或标签页打开时。这通常是由于 selenium 仍在等待旧页面稳定加载所致。解决此问题的关键在于有效利用 webdriverwait 进行显式等待，并正确切换到新打开的窗口句柄，确保自动化流程能顺利在新页面上继续执行。
在使用 Selenium Python 进行 Web 自动化测试时，开发者可能会遇到一个常见问题：在点击某个按钮后，尽管浏览器中对应的操作（如按钮消失、新窗口或标签页打开）已发生，但 Python 代码却停止执行，不再继续后续的指令。终端可能只输出点击前的日志，而点击后的日志却迟迟不出现，给人一种代码“冻结”的错觉。
问题分析
这种现象并非代码真正冻结，而是 Selenium 内部机制在起作用。当一个点击事件触发后，Selenium 默认会等待当前页面（即点击事件发生的页面）达到一个稳定的状态，才会继续执行后续的指令。如果点击操作导致：
- 页面重定向或刷新缓慢： 页面加载时间过长，Selenium 会一直等待。
- 新窗口或标签页打开： 这是最常见的原因。当新窗口打开时，Selenium 的焦点仍然停留在原始窗口上。原始窗口可能因为新窗口的出现而进入某种“不完整”或“未稳定”的状态，导致 Selenium 持续等待，而新窗口的加载与原始窗口的稳定性无关。
在这种情况下，简单的 driver.implicitly_wait() 或 time.sleep() 往往无法解决问题。implicitly_wait 仅在查找元素时生效，而 time.sleep() 则是无差别地暂停，既不智能也可能导致等待时间过长或不足。
解决方案
解决此问题的核心在于两个方面：使用显式等待（WebDriverWait）来精确控制等待条件，以及正确处理新打开的窗口或标签页。
立即学习“Python免费学习笔记（深入）”；
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
1. 显式等待点击元素
在点击按钮之前，确保按钮是可点击的，这有助于避免因元素未加载完全或被覆盖而导致的点击失败。
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
# 假设 driver 已经被初始化
# driver = webdriver.Chrome()
# driver.get("your_initial_url")
print("准备点击按钮...")
button_xpath = "//div[text()='Clique para visualizar']"
try:
# 等待按钮可点击
WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.XPATH, button_xpath))).click()
print("按钮已成功点击。")
except Exception as e:
print(f"点击按钮失败: {e}")
# 根据需要进行错误处理，例如截图、退出等2. 处理新窗口或标签页
当点击操作导致新窗口或标签页打开时，Selenium 的焦点不会自动切换。我们需要手动获取所有窗口句柄，识别出新窗口，然后将驱动程序的焦点切换过去。
import time # 仅用于示例中的短暂暂停，实际应优先使用 WebDriverWait
# ... (接上文代码)
original_window_handle = driver.current_window_handle
initial_window_handles = driver.window_handles # 在点击前获取所有窗口句柄
# ... (点击按钮的代码) ...
# 等待新窗口出现
try:
# 等待直到窗口数量增加
WebDriverWait(driver, 15).until(EC.new_window_is_opened(initial_window_handles))
# 或者，如果确定只会打开一个新窗口，可以等待窗口数量变为初始数量+1
# WebDriverWait(driver, 15).until(EC.number_of_windows_to_be(len(initial_window_handles) + 1))
all_window_handles = driver.window_handles
new_window_handle = None
# 遍历所有句柄，找到与原始句柄不同的那个
for handle in all_window_handles:
if handle != original_window_handle:
new_window_handle = handle
break
if new_window_handle:
driver.switch_to.window(new_window_handle)
print(f"已成功切换到新窗口，标题为: {driver.title}")
# 在新窗口中等待特定元素加载，确保页面稳定
# 替换为新页面上实际存在的元素
new_page_element_xpath = "//h1[contains(text(), '欢迎来到新页面')]"
WebDriverWait(driver, 20).until(EC.presence_of_element_located((By.XPATH, new_page_element_xpath)))
print("新窗口内容已加载完毕，可以继续在新窗口中操作。")
# 在新窗口中执行其他操作，例如输入文本、点击元素等
# driver.find_element(By.ID, "some_input_field").send_keys("Hello New Window!")
# 完成新窗口操作后，可以选择关闭新窗口并切换回原始窗口
# driver.close() # 关闭当前焦点所在的窗口（即新窗口）
# driver.switch_to.window(original_window_handle)
# print(f"已关闭新窗口并切换回原始窗口，当前标题: {driver.title}")
else:
print("错误：未能找到新打开的窗口。")
except Exception as e:
print(f"等待或切换新窗口时发生错误: {e}")
# 错误处理逻辑完整代码示例
将上述逻辑整合，形成一个更完整的示例：
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import time
# 初始化 WebDriver (这里以 Chrome 为例)
driver = webdriver.Chrome()
driver.maximize_window() # 最大化窗口以确保元素可见
driver.get("http://example.com/page_with_button_opening_new_window") # 替换为你的初始URL
print("访问初始页面...")
try:
# 1. 获取原始窗口句柄和当前所有窗口句柄列表
original_window_handle = driver.current_window_handle
initial_window_handles = driver.window_handles
print(f"原始窗口句柄: {original_window_handle}")
print(f"初始窗口数量: {len(initial_window_handles)}")
# 2. 等待按钮可点击并执行点击操作
button_xpath = "//div[text()='Clique para visualizar']" # 替换为你的按钮XPath
print("准备点击按钮...")
WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.XPATH, button_xpath))).click()
print("按钮已成功点击。")
# 3. 等待新窗口出现
print("等待新窗口打开...")
WebDriverWait(driver, 15).until(EC.new_window_is_opened(initial_window_handles))
# 4. 获取所有窗口句柄，并识别新窗口
all_window_handles = driver.window_handles
new_window_handle = None
for handle in all_window_handles:
if handle != original_window_handle:
new_window_handle = handle
break
if new_window_handle:
# 5. 切换到新窗口
driver.switch_to.window(new_window_handle)
print(f"已切换到新窗口，标题为: {driver.title}")
# 6. 在新窗口中等待元素加载，确保页面稳定后进行操作
# 替换为新页面上实际存在的元素，例如一个标题或某个关键组件
new_page_element_xpath = "//h1[contains(text(), '新窗口内容')]" # 假设新窗口有一个H1标题
print(f"在新窗口中等待元素: {new_page_element_xpath}")
WebDriverWait(driver, 20).until(EC.presence_of_element_located((By.XPATH, new_page_element_xpath)))
print("新窗口内容已加载完毕，可以继续操作。")
# 在这里执行新窗口中的自动化操作
# driver.find_element(By.ID, "some_input_on_new_page").send_keys("Test Data")
# driver.find_element(By.XPATH, "//button[text()='Submit']").click()
# 7. (可选) 完成操作后，关闭新窗口并切换回原始窗口
# driver.close()
# driver.switch_to.window(original_window_handle)
# print(f"已关闭新窗口并切换回原始窗口，当前标题: {driver.title}")
else:
print("错误：未能识别新打开的窗口。")
except Exception as e:
print(f"自动化过程中发生错误: {e}")
finally:
# 确保在任何情况下都关闭浏览器
print("自动化测试完成，即将关闭浏览器。")
driver.quit()注意事项
- Timeout 值： WebDriverWait 中的 timeout 参数应根据你的应用响应速度和网络环境进行调整。过短可能导致元素未加载完成就超时，过长则会不必要地延长测试时间。
- expected_conditions 的选择： 针对不同的场景选择最合适的 expected_conditions。例如，EC.element_to_be_clickable 适用于点击前等待，EC.presence_of_element_located 适用于等待元素出现在 DOM 中，EC.visibility_of_element_located 适用于等待元素可见。对于新窗口，EC.new_window_is_opened 或 EC.number_of_windows_to_be 是关键。
- 错误处理： 使用 try-except 块来捕获 TimeoutException 或其他 Selenium 相关的异常，使你的自动化脚本更加健壮。
- 窗口句柄管理： 如果需要频繁在新旧窗口之间切换，务必妥善管理 original_window_handle 和 new_window_handle。
- StaleElementReferenceException： 如果切换回原始窗口后，尝试操作之前找到的元素，可能会遇到 StaleElementReferenceException。这是因为 DOM 可能已经改变，需要重新定位这些元素。
总结
当 Selenium Python 代码在点击后“冻结”时，通常不是代码本身的问题，而是其在等待页面稳定或未正确处理新窗口焦点所致。通过结合使用 WebDriverWait 进行显式等待，并在新窗口打开后及时切换驱动程序的焦点，可以有效解决此类问题，使自动化流程更加流畅和可靠。掌握这些技巧对于编写健壮的 Selenium 自动化测试脚本至关重要。
