加载MetaMask扩展时如何启动无头模式ChromeDriver？

你遇到的是无头Chrome加载MetaMask扩展时的背景页加载失败问题，核心原因在于MetaMask这类交互式扩展依赖完整的浏览器窗口环境，普通无头模式下部分扩展特性被限制，再加上代码中存在重复创建ChromeDriver实例的问题，进一步加剧了加载异常。

1. 修复重复创建ChromeDriver实例的问题 #

你的代码先后创建了两个ChromeDriver实例，会导致资源冲突和逻辑混乱，需合并为一个实例：

[Test]
public async Task Start()
{
    var chromeDriverService = ChromeDriverService.CreateDefaultService();
    var option = new ChromeOptions();

    // 配置扩展与无头模式参数
    option.AddExtension(MainPageElements.extensionPath);
    option.AddArguments("--headless=new"); // 新版无头模式对扩展支持更完善
    option.AddArguments("--window-size=1920,1080"); // 设置窗口尺寸，避免布局异常
    option.AddArguments("--no-sandbox"); // 解决部分环境下的权限限制
    option.AddArguments("--disable-dev-shm-usage"); // 避免内存不足问题
    option.AddArguments("--disable-extensions-except=" + MainPageElements.extensionPath); // 仅加载指定扩展
    option.AddArguments("--load-extension=" + MainPageElements.extensionPath); // 确保扩展被正确识别

    using (var webDriver = new ChromeDriver(chromeDriverService, option))
    {
        // 添加等待逻辑，等待MetaMask扩展初始化完成
        WebDriverWait wait = new WebDriverWait(webDriver, TimeSpan.FromSeconds(10));
        try
        {
            // 等待扩展页面加载完成
            wait.Until(d => d.Url.StartsWith("chrome-extension://"));
        }
        catch (WebDriverTimeoutException)
        {
            // 处理超时，可在此排查扩展路径是否正确
        }
        // 后续业务代码
    }
}

2. 适配MetaMask无头加载的关键配置 #

• 切换新版无头模式：你的ChromeDriver版本为108，若对应Chrome版本为108，可尝试使用--headless=chrome替代--headless=new，旧版headless参数对扩展兼容性较差
• 固定窗口尺寸：无头模式默认窗口极小，会导致MetaMask布局异常，必须显式设置窗口大小
• 扩展加载双保险：同时使用AddExtension和--load-extension参数，确保扩展被正确加载，搭配--disable-extensions-except排除其他扩展干扰
• 添加初始化等待：MetaMask加载需要一定时间，通过WebDriverWait等待扩展页面初始化，避免过早执行后续操作

3. 额外检查项 #

• 确认extensionPath指向的是MetaMask的CRX安装包或解压后的完整扩展文件夹，路径不能包含空格或特殊字符
• 确保ChromeDriver版本与本地Chrome浏览器版本完全匹配（你的ChromeDriver为108.0.5359.7100，对应Chrome版本需为108.x）
• 可先关闭无头模式测试扩展是否能正常加载，排除扩展本身的问题

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