使用Xvfb运行非无头模式Chrome时出现“Chrome not reachable”问题咨询

我之前也遇到过完全一样的问题——为了用不支持无头模式的浏览器扩展，不得不折腾Xvfb+非无头Chrome，结果就碰到了这个chrome not reachable的错误。结合当时的排查经验，给你梳理下原因和可行的解决办法：

出现这个错误的核心原因是Chrome无法成功连接到Xvfb提供的虚拟显示环境，具体可能是以下几种情况：

• Xvfb没有正确启动，或者启动后虚拟显示端口未正常初始化
• Chrome启动时没有指定要连接的Xvfb显示端口，依然尝试寻找真实的物理显示器
• 运行Xvfb和Chrome的用户权限不一致，导致Chrome无法访问虚拟显示资源
• 极少数情况下，Chrome和ChromeDriver的版本兼容性问题（不过你无头模式正常，这个概率很低）

1. 确保Xvfb正确启动并绑定显示端口 #

首先手动启动Xvfb时要明确指定显示编号和屏幕参数，比如：

Xvfb :99 -screen 0 1024x768x16 &

这里的:99是虚拟显示的编号，后续所有操作都要对应这个编号。启动后可以用xdpyinfo -display :99验证是否正常，如果命令能输出显示信息，说明Xvfb没问题。

2. 给Chrome指定连接的虚拟显示 #

有两种方式让Chrome知道要连接Xvfb的虚拟显示：

• 设置环境变量：在运行Python脚本前，先设置DISPLAY变量：

  export DISPLAY=:99
  

  或者在Python代码里直接设置：

  import os
  os.environ['DISPLAY'] = ':99'
  

• 通过ChromeOptions指定参数：在启动Chrome时直接添加--display参数：

  from selenium import webdriver
  from selenium.webdriver.chrome.options import Options
  
  options = Options()
  # 指定连接Xvfb的显示编号
  options.add_argument("--display=:99")
  # 加载你的浏览器扩展
  options.add_argument("--load-extension=/absolute/path/to/your/extension")
  # 可以加上其他必要参数，比如禁用沙箱（某些环境下需要）
  options.add_argument("--no-sandbox")
  
  driver = webdriver.Chrome(options=options)
  

3. 检查权限一致性 #

如果Xvfb是用root用户启动的，而Chrome用普通用户运行，大概率会有权限问题。解决办法：

• 用相同的用户启动Xvfb和Chrome
• 或者给Xvfb的显示文件添加权限：

  chmod 777 /tmp/.X11-unix/X99
  

  这里的X99要对应你启动Xvfb时的显示编号。

4. 增加启动等待时间 #

有时候Xvfb启动后需要短暂的初始化时间，Chrome启动太快会导致连接失败。可以在启动Chrome前加个小延迟：

import time
time.sleep(2)  # 等待2秒让Xvfb完全就绪
driver = webdriver.Chrome(options=options)

5. 禁用Chrome沙箱（必要时） #

在某些Linux环境下，Chrome的沙箱机制会和Xvfb冲突，可以尝试禁用沙箱：

options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")

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