如何使用Python、Selenium和PyVirtualDisplay实现点击打开新窗口？

核心原因说明 #

PyVirtualDisplay本质是虚拟X11显示服务器，本身没有单窗口限制，你遇到的确认窗口无法弹出的问题，90%以上是Chrome配置错误、弹窗被拦截、按钮点击未生效导致的，和PyVirtualDisplay本身无关。

具体修复步骤 #

1. 正确配置PyVirtualDisplay启动参数 #

启动时不要加额外限制窗口的参数，示例配置如下：

from pyvirtualdisplay import Display

display = Display(visible=0, size=(1920, 1080))
display.start()

确保size参数设置足够大的分辨率，避免页面元素被挤出视口导致点击失效。

2. 补充Chrome必要启动参数 #

重点添加弹窗拦截禁用、无沙箱、固定窗口大小的配置，示例如下：

from selenium import webdriver

options = webdriver.ChromeOptions()
# 必加：禁用弹窗拦截，你的确认窗口属于弹窗范畴，默认会被拦截
options.add_argument("--disable-popup-blocking")
# 必加：无GUI环境运行必备参数
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")
# 固定窗口大小，保证元素在视口内
options.add_argument("--window-size=1920,1080")
# 显式加载扩展，避免虚拟环境下扩展丢失
options.add_argument("--load-extension=你的扩展本地目录路径")

driver = webdriver.Chrome(options=options)

3. 优化窗口切换逻辑，避免索引错误 #

不要直接取window_handles[1]，添加显式等待确保新窗口已经弹出后再切换，示例如下：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 点击按钮前先等待按钮可点击
WebDriverWait(driver, 10).until(EC.element_to_be_clickable(你的按钮定位器)).click()
# 等待窗口数量变为2，最多等10秒
WebDriverWait(driver, 10).until(EC.number_of_windows_to_be(2))
# 再切换到新窗口
driver.switch_to.window(driver.window_handles[1])
# 点击确认按钮逻辑
WebDriverWait(driver, 10).until(EC.element_to_be_clickable(确认按钮定位器)).click()
# 等待窗口数量变回1
WebDriverWait(driver, 10).until(EC.number_of_windows_to_be(1))
# 切回原窗口
driver.switch_to.window(driver.window_handles[0])

更轻量的替代方案（可选） #

Chrome 112及以上版本推出的新headless模式原生支持扩展加载，不需要依赖PyVirtualDisplay，配置更简单，只需要在ChromeOptions中添加参数即可：

options.add_argument("--headless=new")

其余扩展加载、窗口切换逻辑和可视环境下完全一致，无需额外配置虚拟显示。

内容的提问来源于stack exchange，提问作者janboro