Mac系统中Selenium与Pyvirtualdisplay无法协同工作问题

问题背景 #

在Linux上，通过Pyvirtualdisplay创建虚拟显示后，ChromeDriver会自动关联到该虚拟显示，完全在后台运行；但在Mac Ventura 13.5.2上，虚拟显示已创建，ChromeDriver却依然在真实桌面窗口启动，无法关联到虚拟显示。环境配置：Selenium 4.4.2、ChromeDriver 117.0.5938.88、已安装XQuartz且Xvfb已加入PATH。

核心原因 #

Mac与Linux的GUI架构完全不同：

• Linux基于X11协议，Pyvirtualdisplay通过启动Xvfb虚拟X服务器并设置DISPLAY环境变量，就能让GUI程序自动关联到虚拟显示。
• Mac原生采用Quartz/Cocoa架构，Chrome在Mac上默认使用原生GUI框架，不会自动读取DISPLAY变量切换到XQuartz的X11兼容层，因此即使启动了Xvfb，Chrome依然会使用真实桌面窗口。

可行解决方案 #

方案1：强制Chrome使用X11模式运行 #

通过Chrome启动参数强制切换到X11模式，让它读取DISPLAY变量并关联到Xvfb的虚拟显示：

from selenium import webdriver
from pyvirtualdisplay import Display
from selenium.webdriver.chrome.options import Options

# 启动虚拟显示
d = Display()
d.start()

# 配置Chrome选项
chrome_options = Options()
# 强制启用X11模式，让Chrome使用XQuartz的X11服务
chrome_options.add_argument("--force-x11")
# 禁用GPU，避免X11环境下的渲染兼容性问题
chrome_options.add_argument("--disable-gpu")

# 启动ChromeDriver
driver = webdriver.Chrome(options=chrome_options)

注意：需确保XQuartz已正确安装并启动（可在XQuartz设置中开启「开机自动启动」），且Chrome支持X11模式（部分新版Chrome可能默认限制，可通过手动执行/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --force-x11验证）。

方案2：使用Chrome原生无头模式（推荐） #

既然Mac原生GUI不兼容X11虚拟显示，直接使用Chrome的无头模式更简单可靠，无需依赖Xvfb和XQuartz：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# Selenium 4+推荐的新版无头模式，功能更接近真实Chrome
chrome_options.add_argument("--headless=new")
# 禁用GPU（无头模式下可选，但能避免部分兼容性问题）
chrome_options.add_argument("--disable-gpu")
# 设置窗口大小，确保页面渲染正常
chrome_options.add_argument("--window-size=1920x1080")

driver = webdriver.Chrome(options=chrome_options)

这种方式完全在后台运行，没有任何窗口弹出，效果和Linux上的虚拟显示一致，且更符合Mac的原生环境。

方案3：手动验证虚拟显示有效性 #

如果方案1无效，可先通过终端手动验证虚拟显示是否正常工作：

1. 启动Xvfb虚拟显示：Xvfb :1 -screen 0 1920x1080x24 &
2. 设置环境变量：export DISPLAY=:1
3. 启动Chrome：/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --force-x11
   如果Chrome能在虚拟显示中运行（无真实窗口弹出），说明代码中可能存在环境变量传递问题，可尝试在代码中手动指定DISPLAY：

import os
from selenium import webdriver
from pyvirtualdisplay import Display
from selenium.webdriver.chrome.options import Options

d = Display()
d.start()
# 手动设置DISPLAY变量，确保Chrome能读取到
os.environ["DISPLAY"] = d.display.display

chrome_options = Options()
chrome_options.add_argument("--force-x11")
driver = webdriver.Chrome(options=chrome_options)

额外注意事项 #

• 确保ChromeDriver与Chrome版本完全匹配（用户当前117版本匹配，无需调整）。
• 若使用XQuartz，需在「安全性」设置中允许「允许来自网络客户端的连接」，避免X11连接被拒绝。

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