基于Miniconda/Anaconda的Docker容器中Selenium启动Chrome异常求助

我之前在Docker+Miniconda环境里踩过完全一样的坑！这种Chrome启动失败的问题真的挺磨人的，结合我当时的排查经验，给你几个可行的解决方向：

1. 先补全Chrome运行所需的系统依赖 #

Chrome在Docker容器里跑需要一堆底层系统库，光装Chrome包根本不够，尤其是Debian/Ubuntu系的镜像，先执行下面的命令把依赖补全：

apt-get update && apt-get install -y \
    chromium \
    chromium-driver \
    xvfb \
    libxss1 \
    libappindicator1 \
    libasound2 \
    libnss3 \
    libgtk-3-0 \
    libgbm1

如果你的镜像用的是google-chrome-stable，把上面的chromium换成它就行，不过chromium在系统源里更易获取，和ChromeDriver的兼容性也没问题。

2. 给ChromeOptions加上必加的启动参数 #

Chrome在无桌面环境下跑必须加几个关键参数，不然大概率崩溃，你的Python脚本里一定要配置这些：

from selenium import webdriver
from xvfbwrapper import Xvfb

# 启动虚拟显示
vdisplay = Xvfb(width=1280, height=720)
vdisplay.start()

# 配置Chrome选项
chrome_options = webdriver.ChromeOptions()
# 核心参数，Docker环境下必须加！禁用沙箱模式，容器默认没有沙箱权限
chrome_options.add_argument('--no-sandbox')
# 解决Docker默认/dev/shm空间不足的问题，让Chrome用临时文件代替
chrome_options.add_argument('--disable-dev-shm-usage')
# 新版无头模式，比旧的--headless更稳定，兼容性更好
chrome_options.add_argument('--headless=new')
# 禁用GPU加速，无桌面环境不需要
chrome_options.add_argument('--disable-gpu')
# 最大化窗口，避免某些页面元素定位问题
chrome_options.add_argument('--start-maximized')

# 初始化Driver
driver = webdriver.Chrome(options=chrome_options)

# 你的业务逻辑代码...

# 清理资源
driver.quit()
vdisplay.stop()

这里划重点：--no-sandbox是Docker环境下的必加项，不加这个几乎100%会出现启动失败的错误。

3. 确保Chrome和ChromeDriver版本严格匹配 #

这是Selenium的经典坑！ChromeDriver的版本必须和你容器里安装的Chrome大版本一致（比如Chrome 114.x对应ChromeDriver 114.x.x）。你可以用下面的命令检查版本：

# 查看Chrome版本
chromium --version
# 查看ChromeDriver版本
chromedriver --version

如果版本不匹配，要么升级/降级Chrome，要么下载对应版本的ChromeDriver替换掉系统里的现有文件。嫌麻烦的话，也可以用webdriver-manager自动匹配版本，代码可以改成这样：

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from xvfbwrapper import Xvfb

vdisplay = Xvfb(width=1280, height=720)
vdisplay.start()

chrome_options = webdriver.ChromeOptions()
chrome_options.add_argument('--no-sandbox')
chrome_options.add_argument('--disable-dev-shm-usage')
chrome_options.add_argument('--headless=new')

# 自动安装匹配版本的ChromeDriver
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()), options=chrome_options)

4. 排查Miniconda环境的依赖冲突 #

有时候用conda install selenium装的包可能和系统的ChromeDriver有冲突，建议用pip安装最新版的相关依赖：

pip install --upgrade selenium webdriver-manager

5. 手动验证xvfb是否正常运行 #

如果上面的方法都不行，可以先手动启动xvfb再跑脚本，排查是不是xvfbwrapper的问题：

# 启动xvfb虚拟显示
Xvfb :1 -screen 0 1280x720x16 &
# 设置DISPLAY环境变量
export DISPLAY=:1
# 运行你的脚本
python your_script.py

如果这样能正常运行，那可能是xvfbwrapper的代码逻辑有问题，或者脚本没有足够权限启动xvfb。

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