Selenium(Java)Chrome无头模式下getText()随机返回空串问题求助

1. 替换无头模式启动参数（解决90%同类问题） #

旧版Chrome无头参数--headless使用独立的渲染内核，和有头模式行为差异极大，存在离屏元素文本不渲染、可见性判定随机失败的已知bug，直接替换为Chrome 112+官方支持的全兼容新无头模式，同时追加稳定渲染参数：

ChromeOptions options = new ChromeOptions();
// 替换旧无头参数，新无头模式完全对齐有头Chrome渲染逻辑
options.addArguments("--headless=new");
// 固定窗口尺寸，避免响应式布局下表格折叠、文本被隐藏
options.addArguments("--window-size=1920,1080");
// 解决无GPU环境下渲染层加载失败问题
options.addArguments("--disable-gpu");
// Linux环境下必加，避免沙箱拦截导致渲染进程崩溃
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");

旧版无头模式默认视口大小为800*600，不会主动渲染视口外的元素文本，表格内容过长出现滚动时，离屏行的文本会被直接丢弃，和你描述的随机返回空现象完全匹配。

2. 修正文本读取逻辑，增加兜底和等待机制 #

现有逻辑找到元素后立刻读取文本，无头模式下DOM节点挂载和文本渲染不同步，加上自定义封装的兼容问题，很容易读到空值，按以下顺序调整：

• 先绕过自定义控件封装排查问题：暂时去掉WebCtrlFactory的TextCtrl包装层，直接调用原生WebElement的方法读取，很多自定义封装会内置可见性、可点击性校验，无头模式下这类校验偶发失败会直接返回空值。
• 加显式等待和轮询校验，等文本完全渲染后再读取，替换原有直接findElements后遍历的逻辑：

String allRolesXpath = String.format("%s%s", TABLE_XPATH, ROLES_XPATH);
WebDriverWait wait = new WebDriverWait(webDriver.getWebDriver(), Duration.ofSeconds(10));
// 先等所有目标元素节点挂载完成
List<WebElement> tableElements = wait.until(ExpectedConditions.presenceOfAllElementsLocatedBy(By.xpath(allRolesXpath)));
// 最多轮询3次，确认所有元素非空
for (int i = 0; i < 3; i++) {
    boolean allReady = tableElements.stream().allMatch(ele -> !ele.getText().trim().isEmpty());
    if (allReady) break;
    Thread.sleep(200);
}

• 增加多层文本读取兜底：当原生getText()因为可见性判定失败返回空时，直接读取DOM属性拿文本，绕过渲染可见性校验：

List<String> roles = new ArrayList<>();
for (WebElement element : tableElements) {
    // 先滚动到元素位置，触发离屏元素渲染
    ((JavascriptExecutor) webDriver.getWebDriver())
            .executeScript("arguments[0].scrollIntoView({block: 'center'});", element);
    Thread.sleep(50);
    String role = element.getText().trim();
    // 逐层兜底
    if (role.isEmpty()) role = element.getAttribute("textContent").trim();
    if (role.isEmpty()) role = element.getAttribute("innerText").trim();
    roles.add(role);
}

3. 排查反爬和特殊渲染逻辑 #

目标站点存在浏览器内核校验，大概率也配套了基础的无头检测逻辑，做两步验证：

• 在读取角色列表的代码节点插入全页截图逻辑，确认截图中角色列的文本确实正常显示，没有被无头检测逻辑通过CSS隐藏（比如字体大小设为0、文本偏移到屏幕外）。
• 打印空值对应元素的outerHTML，确认文本是直接写在DOM节点内，还是通过CSS::before/::after伪元素的content属性渲染——如果是伪元素渲染的内容，getText()和DOM属性都拿不到，需要通过getCssValue()方法读取伪元素内容。

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