Selenium操作Shadow Root在Chrome无头模式失效，求扩展ID获取方案

一、无头模式失效的核心原因 #

1. 窗口尺寸导致布局异常：Chrome无头模式默认窗口尺寸极小，扩展管理页面的核心元素（如extensions-manager）会因布局压缩无法正常渲染，直接导致DOM查询返回null，进而触发读取shadowRoot的报错。
2. 页面加载时序不匹配：无头模式下页面加载、渲染逻辑与正常模式存在差异，原代码未等待元素加载完成就执行DOM查询，此时目标元素尚未初始化，自然返回null。
3. 旧版无头模式兼容性问题：你使用的--headless是旧版无头模式，它与正常Chrome浏览器的DOM结构、API支持有差异，部分shadow root相关的DOM查询逻辑无法兼容。

二、修复无头模式下的扩展ID获取逻辑 #

1. 启用新版无头模式并设置窗口尺寸 #

Chrome 112+推出的新版无头模式（--headless=new）完全对齐正常浏览器行为，同时设置合适的窗口尺寸保证元素正常渲染：

ChromeOptions chromeOptions = new ChromeOptions();
chromeOptions.addArguments("--headless=new"); // 新版无头模式，兼容性更强
chromeOptions.addArguments("--window-size=1920,1080"); // 设置标准窗口尺寸
chromeOptions.addExtensions(new File("Chrome_Extension.crx"));
WebDriverManager.chromedriver().setup();
WebDriver driver = new ChromeDriver(chromeOptions);

2. 添加显式等待确保元素加载完成 #

通过Selenium显式等待，确认目标元素加载完成后再执行shadow root查询：

// 先导航到扩展管理页面
driver.get("chrome://extensions/");

// 显式等待extensions-manager元素加载完成
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
wait.until(driver -> ((JavascriptExecutor) driver).executeScript(
    "return document.querySelector('body > extensions-manager') !== null"
));

// 执行shadowRoot查询并获取扩展ID
JavascriptExecutor js = (JavascriptExecutor) driver;
String extensionId = (String) js.executeScript("""
    return document.querySelector('body > extensions-manager')
            .shadowRoot.querySelector('#items-list')
            .shadowRoot.querySelector('extensions-item')
            .getAttribute('id');
""");

三、更高效的扩展ID获取方案（无需操作扩展页面） #

直接通过Chrome调试协议获取已安装扩展信息，彻底避开shadow root的复杂处理：

ChromeOptions chromeOptions = new ChromeOptions();
chromeOptions.addArguments("--headless=new");
chromeOptions.addArguments("--window-size=1920,1080");
chromeOptions.addArguments("--remote-debugging-port=9222"); // 启用调试端口
chromeOptions.addExtensions(new File("Chrome_Extension.crx"));
WebDriverManager.chromedriver().setup();
WebDriver driver = new ChromeDriver(chromeOptions);

// 通过调试协议获取扩展ID
HttpClient client = HttpClient.newHttpClient();
// 获取调试接口基础地址
HttpRequest versionReq = HttpRequest.newBuilder()
    .uri(URI.create("http://localhost:9222/json/version"))
    .build();
HttpResponse<String> versionResp = client.send(versionReq, HttpResponse.BodyHandlers.ofString());
JsonObject versionJson = JsonParser.parseString(versionResp.body()).getAsJsonObject();
String debuggerBaseUrl = versionJson.get("webSocketDebuggerUrl").getAsString()
        .replace("ws://", "http://")
        .replace("/devtools/browser", "");

// 请求已安装扩展列表
HttpRequest extReq = HttpRequest.newBuilder()
    .uri(URI.create(debuggerBaseUrl + "/json/runtime/evaluate"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"expression\":\"chrome.management.getAll()\"}"))
    .build();
HttpResponse<String> extResp = client.send(extReq, HttpResponse.BodyHandlers.ofString());
JsonObject resultJson = JsonParser.parseString(extResp.body()).getAsJsonObject();
JsonArray extensions = resultJson.get("result").getAsJsonObject().get("value").getAsJsonArray();

// 遍历匹配目标扩展（替换为你的扩展名称）
String targetExtName = "你的扩展名称";
String extensionId = null;
for (JsonElement elem : extensions) {
    JsonObject ext = elem.getAsJsonObject();
    if (ext.get("name").getAsString().equals(targetExtName)) {
        extensionId = ext.get("id").getAsString();
        break;
    }
}

System.out.println("扩展ID：" + extensionId);
driver.quit();

注：需引入Gson库处理JSON解析，或使用其他JSON解析工具。

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