Selenium WebDriver：同一窗口ID下窗口切换及模态框元素定位求助

我曾尝试在另一问题下添加评论，但因需要最低50声望而失败，因此更新代码求助以下场景：我有一个仪表盘页面，页面内有展示用户的网格视图，点击用户名后，会在同一页面弹出带有用户名和密码字段的“新窗口”（实际为模态框），我需要在此“新窗口”中输入文本，但我的代码无法正常运行。

我的代码： #

System.setProperty("webdriver.chrome.driver", "C:\\chromedriver_win32\\chromedriver.exe"); 
WebDriver driver = new ChromeDriver(); 
driver.get("https://web.mauditor.com/Login/SignIn"); 
driver.manage().window().maximize(); 
driver.findElement(By.id("UserName")).sendKeys("ajay0094"); 
driver.findElement(By.id("Password")).sendKeys("12341234"); 
driver.findElement(By.id("btnsubmit")).click(); 
Thread.sleep(3000); 
driver.findElement(By.xpath("//*[@id='leftpaneldiv']/ul/li[1]")); 
driver.findElement((By.cssSelector(".treeview > a:nth-child(1) > span:nth-child(1)"))).click(); 
Thread.sleep(2000); 
driver.switchTo().frame(driver.findElement(By.id("usermgmtframe"))); 
driver.findElement(By.id("txtName")).sendKeys("Joe"); 
Thread.sleep(3000); 
driver.findElement(By.xpath("/html/body/div[1]/div[1]/div[1]/div/div/div/div/form/div[2]/div/div[2]/div/div/div/table/tbody/tr/td[6]/a[4]/img")).click(); 
String parent_window = driver.getWindowHandle(); 
System.out.println("Parent Window ID is : "+parent_window); 
java.util.Set<String> allWindows = driver.getWindowHandles(); 
int count = allWindows.size(); 
System.out.println("Now Total Windows : "+count); 
for(String child_1:allWindows) 
    if(parent_window.equalsIgnoreCase(child_1)) 
        driver.switchTo().window(child_1); 
System.out.println(driver.getTitle()); 
String child1_window = driver.getWindowHandle(); 
System.out.println("Child 1 Window ID is : "+child1_window); 
driver.findElement(By.id("modal-close")).click(); 
driver.findElement(By.id("UserName")).sendKeys("AJAY"); 

输出结果： #

Parent Window ID is : CDwindow-DD4195D132ED64B192AB85F0846D5699
Now Total Windows : 1
mAuditor - Manage Users
Child 1 Window ID is : CDwindow-DD4195D132ED64B192AB85F0846D5699
Exception in thread "main" org.openqa.selenium.NoSuchElementException: no such element: Unable to locate element: {"method":"id","selector":"modal-close"} (Session info: chrome=66.0.3359.181)

问题分析 #

你的代码出现异常主要有三个核心问题：

1. 错误处理模态框：你用了switchTo().window()尝试切换窗口，但这个"新窗口"是页面内的模态框（Modal），并非独立的浏览器窗口，窗口切换代码完全没必要，反而会干扰元素定位逻辑。
2. 不可靠的等待方式：Thread.sleep()是固定时长等待，无法保证元素完全渲染完成，经常会出现代码在元素还没加载出来时就尝试定位，最终抛出NoSuchElementException。
3. Frame上下文未切换：之前你切换到了usermgmtframe这个iframe中，而模态框大概率是在主文档（顶层上下文）里，不切回主文档就找不到模态框的元素。

解决方案 #

我帮你调整了代码，解决了上述问题，具体修改如下：

• 移除所有窗口切换代码（模态框不是新窗口）
• 用**显式等待（Explicit Wait）**替代Thread.sleep()，确保元素可见/可点击后再操作
• 点击弹出模态框后，切回主文档（如果模态框不在iframe内）
• 等待模态框元素加载完成后再执行操作

修改后的代码：

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;

import java.time.Duration;

public class ModalTest {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "C:\\chromedriver_win32\\chromedriver.exe");
        WebDriver driver = new ChromeDriver();
        WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10)); // 设置10秒显式等待超时

        try {
            driver.get("https://web.mauditor.com/Login/SignIn");
            driver.manage().window().maximize();

            // 登录操作：等待元素可见后输入
            wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("UserName"))).sendKeys("ajay0094");
            wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("Password"))).sendKeys("12341234");
            wait.until(ExpectedConditions.elementToBeClickable(By.id("btnsubmit"))).click();

            // 导航到用户管理页面
            wait.until(ExpectedConditions.elementToBeClickable(By.cssSelector(".treeview > a:nth-child(1) > span:nth-child(1)"))).click();

            // 切换到用户管理iframe
            WebElement userFrame = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("usermgmtframe")));
            driver.switchTo().frame(userFrame);

            // 搜索用户并点击弹出模态框
            wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("txtName"))).sendKeys("Joe");
            wait.until(ExpectedConditions.elementToBeClickable(By.xpath("/html/body/div[1]/div[1]/div[1]/div/div/div/div/form/div[2]/div/div[2]/div/div/div/table/tbody/tr/td[6]/a[4]/img"))).click();

            // 切回主文档（模态框不在iframe内）
            driver.switchTo().defaultContent();

            // 等待模态框关闭按钮可见并点击
            wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("modal-close"))).click();

            // 如果需要在模态框内输入用户名，先等待输入框可见再操作
            // wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("UserName"))).sendKeys("AJAY");

        } finally {
            // driver.quit(); // 测试完成后可以关闭浏览器
        }
    }
}

额外提示 #

• 尽量避免使用绝对XPath（比如/html/body/...），页面结构稍有变化就会失效，建议改用相对XPath或CSS选择器
• 显式等待是Selenium官方推荐的等待方式，比Thread.sleep()更稳定、高效
• 如果模态框确实在iframe内，就不需要执行switchTo().defaultContent()，可以通过浏览器开发者工具检查模态框的DOM位置来确认

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