在自动化测试与爬虫场景中，Brave 浏览器凭借其隐私保护和低资源占用逐渐受到关注。SeleniumBase 是一个构建在 Selenium 之上的测试框架，简化了用例编写与执行流程。虽然它原生主要面向 Chrome、Firefox 等，但借助 Chromium 同宗特性，我们完全可以驱动 Brave 完成自动化任务。下面介绍具体的配置方式与实践中需要注意的问题。
一、Brave 与 SeleniumBase 的兼容原理
Brave 桌面版本质上使用了 Chromium 内核，其渲染与网络栈和 Google Chrome 高度一致，因此 ChromeDriver 通常也能驱动 Brave，只要告诉驱动 Brave 的可执行文件路径即可。SeleniumBase 在底层通过 selenium.webdriver.Chrome 启动浏览器，并允许通过 driver_options 或自定义参数覆盖二进制位置。
需要注意的是，Brave 的发布节奏与 Chrome 并不完全同步，尽管二者版本号接近，但仍可能出现驱动协议不匹配。在实践中，应保证 Brave 版本、ChromeDriver 版本以及 SeleniumBase 所依赖的 Selenium 库之间处于可兼容区间。一般建议下载与 Brave 版本对应的 Chromium 大版本驱动，并在 CI 环境中锁定版本号以避免意外升级。
二、基础配置：指定 Brave 二进制路径
最常见的方式是在启动测试时，通过环境变量或代码显式设置 Brave 的安装路径。Windows 下通常位于 C:Program FilesBraveSoftwareBrave-BrowserApplicationbrave.exe，Linux 多为 /usr/bin/brave-browser，macOS 则在 /Applications/Brave Browser.app/Contents/MacOS/Brave Browser。我们可以在 pytest 的 conftest 中注入配置。
下面示例展示如何使用 SeleniumBase 的 Driver 上下文并传入 Chrome 选项来指向 Brave：
from seleniumbase import Driver
from selenium.webdriver.chrome.options import Options
def test_brave_open():
options = Options()
# 指定 Brave 浏览器可执行文件
options.binary_location = "/usr/bin/brave-browser"
# 添加常用实验参数
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")
driver = Driver(uc=False, headless=False, driver_options=options)
driver.get("https://ipipp.com")
print(driver.title)
driver.quit()
上述代码中，Driver 是 SeleniumBase 提供的封装类，driver_options 接收标准的 Chrome 选项对象。由于 Brave 兼容 Chrome 参数，我们可以直接复用 --no-sandbox 等开关。若运行在 Docker 或 root 用户下，必须加上 --no-sandbox，否则浏览器会拒绝启动。
三、pytest 全局配置与最佳实践
在较大项目中，每次在用例里写路径不利于维护。可以通过 conftest.py 统一处理，并结合环境变量区分操作系统。这样既方便本地调试，也利于流水线部署。
import os
from seleniumbase import BaseCase
class BraveBaseCase(BaseCase):
def setUp(self):
options = self.driver_options()
if os.name == "posix":
options.binary_location = "/usr/bin/brave-browser"
elif os.name == "nt":
options.binary_location = r"C:Program FilesBraveSoftwareBrave-BrowserApplicationbrave.exe"
options.add_argument("--disable-gpu")
self.driver = self.get_new_driver(browser="chrome", options=options)
super().setUp()
def tearDown(self):
self.driver.quit()
super().tearDown()
上面的 BraveBaseCase 继承自 SeleniumBase 的 BaseCase，重写了 setUp 来注入 Brave 路径。这样的结构让业务测试类只需继承该类即可获得 Brave 环境，不必关心底层细节。同时，将用户数据目录通过 --user-data-dir 隔离，可以避免多个用例之间缓存与登录态互相污染。
另外，推荐开启 --headless=new 新无头模式以提升稳定性，老版无头在 Brave 中部分特性支持不完善。对于需要拦截广告的场景，Brave 自带屏蔽比安装插件更轻量，但也可能导致某些统计脚本不加载，写断言时要考虑这一点。
四、常见坑与排查思路
第一类问题是驱动找不到浏览器。报错多为 session not created 或二进制不存在。此时应打印 binary_location 确认路径真实存在，并且该文件有可执行权限。Linux 上常因包管理器安装名不同，比如有的发行版叫 brave 而非 brave-browser。
第二类是版本错配。ChromeDriver 若明显低于 Brave 内核版本，会提示协议错误。解决办法是使用 SeleniumBase 自带的 seleniumbase install chromedriver 机制，或手动下载匹配驱动并放到 PATH。下表列出典型组合：
| Brave 版本 | 对应 Chromium 大版本 | 驱动建议 |
|---|---|---|
| 1.50.x | 112 | ChromeDriver 112.x |
| 1.60.x | 119 | ChromeDriver 119.x |
| 1.70.x | 125 | ChromeDriver 125.x |
第三类是沙箱与共享内存。在容器里如果不加 --disable-dev-shm-usage，浏览器容易崩溃。配合 --no-sandbox 基本能解决绝大多数 Linux 启动异常。若仍失败，可临时用 --enable-logging --v=1 启动并查看标准错误输出定位。
五、性能与扩展建议
Brave 默认开启较多隐私保护，在自动化中可能拖慢首屏，因为要处理指纹随机化。如果测试不关注隐私，可通过选项关闭部分特性以提升速度。此外，SeleniumBase 的 uc=True 反检测模式主要针对 Chrome，对 Brave 效果有限，不建议强依赖。
对于长期任务，使用单独的用户目录配合 --disk-cache-size 限制缓存，可以防止磁盘占满。结合 SeleniumBase 的失败截图与日志，能够快速定位 Brave 特有的渲染差异。总的来说，把 Brave 当作定制版 Chrome 来驱动，配合稳定的路径与版本管理，就能在项目中平滑落地。
SeleniumBaseBrave_browserautomation_testing修改时间：2026-08-01 02:51:30