静态模式WebDriverWait问题：TestNG正常Jar包main方法超时

这种情况我之前踩过坑！同样的代码在TestNG里跑完全正常，打包成Jar独立运行就超时，核心原因大多是TestNG测试环境和Jar独立运行时的浏览器上下文、环境配置差异导致的，给你几个排查方向和解决方案：

1. 检查浏览器启动参数是否完整 #

TestNG在IDE里运行时，浏览器通常是在完整的桌面环境下启动的，但Jar包运行时（尤其是在无桌面的服务器环境），浏览器需要额外的启动参数才能正常渲染页面。以Chrome为例，一定要加上这些关键参数：

ChromeOptions options = new ChromeOptions();
// 禁用沙箱，避免权限限制导致的渲染问题
options.addArguments("--no-sandbox");
// 解决/dev/shm内存不足的常见问题
options.addArguments("--disable-dev-shm-usage");
// 设置固定窗口大小，避免元素因窗口过小被隐藏或未渲染
options.addArguments("--window-size=1920,1080");
// 如果是无头环境运行，必须启用新的无头模式（Chrome 112+推荐）
options.addArguments("--headless=new");

WebDriver driver = new ChromeDriver(options);

2. 调整页面加载策略 #

默认的页面加载策略是normal（等待所有资源完全加载），但很多现代页面用异步加载，目标元素可能已经渲染完成，但页面还在加载其他资源，导致WebDriverWait超时。可以把加载策略改成EAGER（DOM加载完成就继续执行）：

ChromeOptions options = new ChromeOptions();
options.setPageLoadStrategy(PageLoadStrategy.EAGER);

3. 优化等待条件的逻辑 #

有时候visibilityOfElementLocated会因为元素被加载遮罩、弹窗等其他元素覆盖而判定为不可见，你可以换成更灵活的自定义等待条件，先确认元素存在再检查可见性：

WebDriverWait wait = new WebDriverWait(driver, 60);
wait.until(driver -> {
    try {
        WebElement element = driver.findElement(By.id("map_background_3d"));
        // 同时验证元素可见且可交互
        return element.isDisplayed() && element.isEnabled();
    } catch (NoSuchElementException | StaleElementReferenceException e) {
        return false;
    }
});

4. 确认Jar包的依赖完整性 #

打包成可执行Jar时，很容易出现依赖缺失或版本冲突的问题。比如Selenium的support包、浏览器驱动的依赖是否都被正确打包？建议用Maven Shade Plugin或者Gradle Shadow Plugin打包，确保所有依赖都被包含，且版本和TestNG测试环境一致（避免版本差异导致的兼容性问题）。

5. 检查运行环境的图形支持 #

如果Jar是在没有图形界面的服务器上运行，浏览器无法正常渲染页面，自然找不到目标元素。这时候需要用虚拟桌面工具（比如Xvfb）来模拟桌面环境，启动浏览器前先初始化虚拟桌面：

# Linux环境下先启动虚拟桌面
Xvfb :99 -screen 0 1920x1080x16 &
export DISPLAY=:99
# 再运行Jar包
java -jar your-test.jar

优先从第1、2点开始排查，这是最常见的触发原因！

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