Selenium ChromeDriver无法加载Swagger UI动态内容问题求助

问题详情 #

我编写了一个集成测试用于验证应用的Swagger UI是否可访问，但测试中waitForLoad()函数始终超时，driver.getPageSource()仅返回页面骨架，无动态渲染内容。本地打开相同Swagger地址可正常加载，尝试延长超时时间、修改headless参数均无效。

ChromeDriver配置代码 #

chrome = new BrowserWebDriverContainer<>()
        .withCapabilities(new ChromeOptions().setHeadless(true));
chrome.start();
driver = chrome.getWebDriver();
driver
    .manage()
    .timeouts()
    .implicitlyWait(10, TimeUnit.SECONDS);

测试代码 #

String url = String.format("http://host.testcontainers.internal:%d/swagger#/%s", servicePort, endpointPath);
driver.get(url);
waitForLoad(driver);

private void waitForLoad(WebDriver driver) {
  ExpectedCondition<Boolean> pageLoadCondition = driver1 -> {
    return Objects
        .requireNonNull(driver1)
        .getPageSource()
        .contains("Try it out");
  };
  WebDriverWait wait = new WebDriverWait(driver, 60);
  wait.until(pageLoadCondition);
}

ChromeDriver配置信息 #

{
  "acceptInsecureCerts": false,
  "acceptSslCerts": false,
  "applicationCacheEnabled": false,
  "browserConnectionEnabled": false,
  "browserName": "chrome",
  "chrome": {
    "chromedriverVersion": "2.43.600233(523efee95e3d68...)",
    "userDataDir": "/tmp/.org.chromium.Chromium..."
  },
  "cssSelectorsEnabled": true,
  "databaseEnabled": false,
  "goog:chromeOptions": {
    "debuggerAddress": "localhost:35709"
  },
  "handlesAlerts": true,
  "hasTouchScreen": false,
  "javascriptEnabled": true,
  "locationContextEnabled": true,
  "mobileEmulationEnabled": false,
  "nativeEvents": true,
  "networkConnectionEnabled": false,
  "pageLoadStrategy": "normal",
  "platform": "LINUX",
  "platformName": "LINUX",
  "rotatable": false,
  "setWindowRect": true,
  "takesHeapSnapshot": true,
  "takesScreenshot": true,
  "unexpectedAlertBehaviour": "",
  "unhandledPromptBehavior": "",
  "version": "70.0.3538.77",
  "webStorageEnabled": true,
  "webdriver.remote.sessionid": "694e7496e5aa8c005ef9421e3b1..."
}

解决思路与方案 #

1. 补充Headless Chrome容器运行必需参数 #

容器环境下运行Headless Chrome需要额外参数规避资源限制，同时设置窗口大小确保页面正常渲染：

ChromeOptions options = new ChromeOptions();
options.setHeadless(true);
// 容器运行必需参数，避免权限/资源不足问题
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");
// 设置窗口大小，防止小窗口导致动态元素不渲染
options.addArguments("--window-size=1920,1080");

chrome = new BrowserWebDriverContainer<>()
        .withCapabilities(options);

2. 修改等待逻辑：直接等待目标元素而非检查页面源码 #

getPageSource()无法实时反映动态渲染的DOM内容，改为等待"Try it out"按钮元素可见，逻辑更可靠：

private void waitForLoad(WebDriver driver) {
    WebDriverWait wait = new WebDriverWait(driver, 60);
    // 等待目标按钮可见
    wait.until(ExpectedConditions.visibilityOfElementLocated(
        By.xpath("//button[contains(text(), 'Try it out')]")
    ));
}

3. 确认ChromeDriver与Chrome版本兼容性 #

当前Chrome版本70.0.3538.77与ChromeDriver 2.43版本匹配，若问题仍存在，可尝试更换对应版本的稳定ChromeDriver，排除潜在兼容隐患。

4. 前置检查服务状态 #

确保测试执行前，后端服务已完全初始化并能正常响应请求，可添加服务健康检查逻辑，避免因服务未就绪导致Swagger UI加载失败。

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