Selenium无法定位页面复选框 等待元素可点击触发超时异常

问题表现 #

• 驱动无头Chrome执行页面输入交互时，目标复选框始终无法被识别，分别测试无等待、100秒长等待方案，均抛出元素未找到报错
• 尝试ID、XPath两种定位策略，搭配visibilityOfElementLocated、elementToBeClickable两类显式等待条件，问题仍复现
• Chrome开发者工具元素面板中验证使用的XPath表达式，可唯一匹配目标元素，排除XPath写法错误

测试代码 #

val wait = WebDriverWait(driver, 30)
    //wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//*[@name = 'element_ID']")))
wait.until(ExpectedConditions.elementToBeClickable(By.xpath("//*[@name = 'element_ID']")))

val elem: WebElement = driver.findElement(By.xpath("//*[@id = 'element_ID']"))
elem.click()

异常日志 #

org.openqa.selenium.TimeoutException: Expected condition failed: waiting for element 
to be clickable: By.xpath: //*[@name = 'element_ID'] (tried for 30 second(s) with 500 milliseconds interval)
Build info: version: '3.141.59', revision: 'e82be7d358', time: '2018-11-14T08:17:03'
System info: host: 'xxx', ip: 'xxx', os.name: 'Mac OS X', os.arch: 'x86_64', os.version: '12.4', java.version: '1.8.0_321'
Driver info: org.openqa.selenium.chrome.ChromeDriver
Capabilities {acceptInsecureCerts: false, acceptSslCerts: false, applicationCacheEnabled: false, browserConnectionEnabled: false, browserName: chrome, chrome: {chromedriverVersion: 2.38.552518 (183d19265345f5..., userDataDir: /var/folders/06/072_bdvx0rs...}, cssSelectorsEnabled: true, databaseEnabled: false, handlesAlerts: true, hasTouchScreen: false, javascriptEnabled: true, locationContextEnabled: true, mobileEmulationEnabled: false, nativeEvents: true, networkConnectionEnabled: false, pageLoadStrategy: normal, platform: MAC, platformName: MAC, rotatable: false, setWindowRect: true, takesHeapSnapshot: true, takesScreenshot: true, unexpectedAlertBehaviour: , unhandledPromptBehavior: , version: 103.0.5060.53, webStorageEnabled: true}
Session ID: 2d1c4aab1e9780033abcd6891537a5dsf

问题根因 #

• 驱动版本严重不匹配：日志显示Chrome浏览器版本为103.0.5060.53，对应使用的chromedriver版本为2.38，该版本驱动最高仅支持Chrome 65-67版本，版本差过大会导致无头模式下DOM树解析、元素状态识别完全异常
• 定位逻辑前后不一致：显式等待阶段校验的是name属性为element_ID的元素，实际查找点击的是id属性为element_ID的元素，两个定位条件指向的不是同一个节点，等待结果无意义
• 无头模式默认配置缺陷：默认启动的无头浏览器窗口尺寸远小于常规桌面端尺寸，响应式页面会将复选框收纳到折叠区域、或被其他元素遮挡，导致elementToBeClickable条件始终无法满足；部分站点会检测无头浏览器特征，直接隐藏表单元素拦截自动化操作

修复步骤 #

• 更换匹配版本的chromedriver，103版本Chrome对应使用103.x系列chromedriver，解决版本兼容导致的基础识别问题
• 统一元素定位逻辑，等待阶段和实际查找阶段使用同一个定位器，不要混用不同属性的匹配规则
• 无头浏览器启动时追加固定窗口尺寸参数：--window-size=1920,1080，模拟常规桌面端视口大小，避免响应式布局导致元素不可见
• 若存在元素遮挡、点击拦截问题，直接通过JS执行点击绕过页面交互校验，参考代码：

val elem: WebElement = wait.until(ExpectedConditions.presenceOfElementLocated(By.id("element_ID")))
(driver as JavascriptExecutor).executeScript("arguments[0].click();", elem)

• 若站点存在无头特征检测，追加启动参数伪装UA：--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36，同时关闭自动化标识参数--disable-blink-features=AutomationControlled

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