在树莓派上使用SeleniumBase时禁止自动启用无头模式的问题

问题分析 #

在Windows环境下使用Driver(uc=True)能正常显示浏览器窗口，但部署到树莓派后自动切换为无头模式，核心原因是SeleniumBase在ARM架构的Linux环境（树莓派）中，启用UC模式时会默认开启无头模式以适配无桌面场景，但如果你的树莓派具备桌面环境，就需要显式覆盖这个默认行为。

解决方案 #

1. 显式关闭无头模式 #

修改代码，在初始化Driver时添加headless=False和xvfb=False参数，强制禁用无头模式与虚拟显示：

from seleniumbase import Driver

# 保留UC模式，同时强制显示浏览器界面
driver = Driver(uc=True, headless=False, xvfb=False)
driver.get('https://www.google.com/')

2. 确保桌面显示权限 #

如果运行代码时仍无法显示界面，需确认当前用户有权限访问树莓派的桌面显示：

• 终端运行前先执行：export DISPLAY=:0
• 或者在代码中直接设置环境变量：

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

from seleniumbase import Driver
driver = Driver(uc=True, headless=False, xvfb=False)
driver.get('https://www.google.com/')

3. 验证浏览器与驱动兼容性 #

树莓派通常使用Chromium而非Chrome，需确保：

• 已安装适配ARM架构的Chromium浏览器
• SeleniumBase的驱动版本与Chromium版本匹配（可通过pip install --upgrade seleniumbase更新至最新版本）

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