使用Headless Chrome搭配Selenium时出现TimeoutException问题求助

API 探路者

2026-7-9

解决Headless Chrome下TimeoutException的方案

核心修改点及原因：

修正无头模式窗口配置：
无头模式下--start-maximized参数常失效，改用--window-size=1920,1080指定明确分辨率，确保页面元素正常渲染；同时删除冗余的driver.manage().window().maximize();（无头模式下该操作无效）。
添加反识别参数：
补充模拟正常浏览器的user-agent，以及解决环境问题的--no-sandbox、--disable-dev-shm-usage参数，避免被网站判定为自动化工具。
优化元素定位逻辑：
用ID定位（By.id("srch-term")）替代XPath，定位更高效可靠；等待到可点击元素后直接复用，无需重复调用driver.findElement。

修改后的完整代码：

ChromeOptions options = new ChromeOptions();

// 调整无头模式参数，添加必要的模拟配置
options.addArguments(
    "headless",
    "--window-size=1920,1080",
    "--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36",
    "--enable-features=ReaderMode",
    "--kiosk-printing",
    "--disable-notifications",
    "--disable-gpu",
    "--no-sandbox",
    "--disable-dev-shm-usage"
);

WebDriver driver = new ChromeDriver(options);
driver.get("https://www.dinamani.com/"); 

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(180));    

// 直接复用等待后的元素执行输入操作
WebElement searchBox = wait.until(ExpectedConditions.elementToBeClickable(By.id("srch-term")));
searchBox.sendKeys("பொருநை போற்றுதும்");