Java-Selenium ChromeDriver加载新页面后无响应问题求助

问题背景 #

我有一个登录网页并执行后续操作的Selenium脚本，登录逻辑能正常运行，但登录后执行元素查找时出现异常：

• 直接查找目标元素会因页面未加载完成抛出「找不到元素」错误
• 添加隐式等待或显式等待后，脚本会直接挂起，不再执行后续代码（连打印语句都不会运行）

登录核心代码 #

WebDriver driver;
JavascriptExecutor exec;

String dni = "...";
String passwd = "...";

driver = new ChromeDriver();
exec = (JavascriptExecutor) driver;

// 访问网页
driver.get("http://example.com");

// 接受Cookie
driver.findElement(By.id("aceptarCookies")).click();

// 登录
driver.findElement(By.id("areaPersonal")).click();
driver.findElement(By.id("tab_login_user")).sendKeys(dni);
driver.findElement(By.id("tab_login_password")).sendKeys(passwd);
driver.findElement(By.id("loginFormHeader")).findElement(By.id("buttonHeader")).click();

异常现象详情 #

1. 无等待直接查找元素
   执行代码：

// 查找主体元素
driver.findElement(By.id("my_panel_page"));

错误输出：

... (Initialize ChromeDriver)
    
no such element: Unable to locate element: {"method":"css selector","selector":"#my_panel_page"}
  (Session info: chrome=109.0.5414.120)
Build info: version: '3.141.59', revision: 'e82be7d358', time: '2018-11-14T08:17:03'
System info: host: 'xxx', ip: 'xxx', os.name: 'Windows 11', os.arch: 'amd64', os.version: '10.0', java.version: '11.0.16.1'
Driver info: org.openqa.selenium.chrome.ChromeDriver
Capabilities {acceptInsecureCerts: false, browserName: chrome, browserVersion: 109.0.5414.120, chrome: {chromedriverVersion: 109.0.5414.74 (e7c5703604da..., userDataDir: C:\Users\xxx\AppData\Loca...}, goog:chromeOptions: {debuggerAddress: localhost:52373}, javascriptEnabled: true, networkConnectionEnabled: false, pageLoadStrategy: normal, platform: WINDOWS, platformName: WINDOWS, proxy: Proxy(), setWindowRect: true, strictFileInteractability: false, timeouts: {implicit: 0, pageLoad: 300000, script: 30000}, unhandledPromptBehavior: dismiss and notify, webauthn:extension:credBlob: true, webauthn:extension:largeBlob: true, webauthn:virtualAuthenticators: true}
Session ID: 533a8a11a33254b8ab788522dada77ab
*** Element info: {Using=id, value=my_panel_page}

2. 添加显式等待后挂起
   执行代码：

WebDriverWait wait = new WebDriverWait(driver, 20);
wait.until(ExpectedConditions.presenceOfElementLocated(By.id("id_of_new_item")));
System.out.println("Page loaded!!!");
driver.findElement(By.id("my_panel_page"));

现象：ChromeDriver初始化并成功登录后，执行到等待语句就挂起，仅输出初始化日志：

Starting ChromeDriver 109.0.5414.74 (e7c5703604daa9cc128ccf5a5d3e993513758913-refs/branch-heads/5414@{#1172}) on port 15136
Only local connections are allowed.
ChromeDriver was started successfully.
feb. 01, 2023 5:28:28 P. M. org.openqa.selenium.remote.ProtocolHandshake createSession
INFORMACIËN: Detected dialect: W3C

使用版本信息 #

• ChromeDriver: 109.0.5414.74
• Chrome: 109.0.5414.120
• Selenium: 3.141.59
• JDK: 11.0.16.1

已确认目标元素确实存在于页面HTML中，且脚本数月前可正常运行。

排查与解决方案 #

1. 检查页面是否存在iframe嵌套 #

登录后页面可能通过iframe加载内容，导致当前上下文无法定位到iframe内的元素。可先切换到对应iframe再查找：

// 等待iframe加载并切换上下文
WebDriverWait wait = new WebDriverWait(driver, 20);
WebElement iframe = wait.until(ExpectedConditions.presenceOfElementLocated(By.id("目标iframe的ID")));
driver.switchTo().frame(iframe);
// 之后再查找目标元素
driver.findElement(By.id("my_panel_page"));
// 操作完成后切回主文档（若后续需操作主页面元素）
driver.switchTo().defaultContent();

2. 修正显式等待的目标元素ID #

你的显式等待代码中使用的id_of_new_item与实际要查找的my_panel_page不匹配，导致等待超时挂起。修改为正确的元素ID，且优先使用visibilityOfElementLocated确保元素可见：

WebDriverWait wait = new WebDriverWait(driver, 20);
wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("my_panel_page")));
System.out.println("Page loaded!!!");
driver.findElement(By.id("my_panel_page"));

3. 避免隐式等待与显式等待混用 #

Selenium 3.x中同时使用两种等待方式会导致不可预测的等待时间，建议只保留显式等待，删除隐式等待配置。

4. 修改页面加载策略 #

默认的normal策略会等待所有资源加载完成，若页面有大量异步内容，可改为eager策略（仅等待DOM加载完成）：

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

5. 验证元素定位方式的正确性 #

若元素ID存在动态变化（如带随机后缀），可改用XPath/CSS选择器结合其他属性定位：

// 示例：结合class属性和元素文本定位
driver.findElement(By.xpath("//div[@class='panel-container' and text()='个人中心']"));

6. 对齐浏览器与驱动版本 #

虽然版本号接近，但微小差异也可能引发兼容性问题。将ChromeDriver升级到与Chrome完全一致的版本（109.0.5414.120）。

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