Selenium用ID/XPath定位元素报错，用Name定位正常的问题求助

编写Selenium自动化测试脚本时，切换到子窗口后执行以下代码：

driver.findElement(By.id("UserFirstName-m8NQ")).sendKeys("sam");
driver.findElement(By.xpath("//*[@id='UserFirstName-m8NQ']")).sendKeys("sam");

抛出异常：

Exception in thread "main" org.openqa.selenium.NoSuchElementException: no such element: Unable to locate element: {"method":"xpath","selector":"//*[@id='UserFirstName-m8NQ']"}

但使用driver.findElement(By.name("UserFirstName")).sendKeys("sam");却能正常运行，完整脚本如下：

public class First {
public static String browser = "chrome";
public static WebDriver driver;
public static void main(String[] args) throws InterruptedException {

    if (browser.equals("firefox")) {
        WebDriverManager.firefoxdriver().setup();
        driver = new FirefoxDriver();
    }

    if (browser.equals("chrome")) {
        WebDriverManager.chromedriver().setup();
        driver = new ChromeDriver();
    }

    driver.get("https://www.salesforce.com/in/");

    driver.findElement(
            By.xpath("//*[@id=\"main\"]/div[2]/div/div/div/div[2]/div[1]/div[1]/div[3]/div/div[1]/div/a")).click();

    Set<String> windowHandles = driver.getWindowHandles();

    Iterator<String> windowIterator = windowHandles.iterator();
    String parentWindow = windowIterator.next();
    String childWindow = windowIterator.next();

    System.out.println(driver.getTitle());

    driver.switchTo().window(childWindow);

    System.out.println(driver.getTitle());

    driver.findElement(By.id("UserFirstName-m8NQ")).sendKeys("sam");
    driver.findElement(By.xpath("//*[@id='UserFirstName-m8NQ']")).sendKeys("sam");

    driver.findElement(By.name("UserFirstName")).sendKeys("sam");
}
}

请问为何ID和XPath定位会失败，而Name定位正常？该如何解决？

原因分析 #

• 动态ID生成：Salesforce的表单元素ID是动态生成的，比如UserFirstName-m8NQ中的-m8NQ是随机后缀，每次刷新或重新加载页面都会变化。用固定的完整ID或基于该ID的XPath定位，自然找不到元素。
• Name属性稳定：UserFirstName这个name属性是静态配置的，不会随页面加载动态改变，所以能稳定定位到目标元素。

解决方法 #

• 优先使用静态属性定位：直接用name属性定位，或者选择其他稳定的属性（比如class如果不动态变化的话），也可以用标签+静态属性的组合XPath，比如：

  driver.findElement(By.xpath("//input[@name='UserFirstName']")).sendKeys("sam");
  

• 针对动态ID的定位技巧：如果必须基于ID定位，可以用部分匹配的方式：
  • XPath部分匹配：

    // 匹配ID以UserFirstName-开头的元素
    driver.findElement(By.xpath("//input[starts-with(@id, 'UserFirstName-')]")).sendKeys("sam");
    // 匹配ID包含UserFirstName的元素
    driver.findElement(By.xpath("//input[contains(@id, 'UserFirstName')]")).sendKeys("sam");
    

  • CSS选择器部分匹配：

    // 匹配ID以UserFirstName-开头的元素
    driver.findElement(By.cssSelector("input[id^='UserFirstName-']")).sendKeys("sam");
    // 匹配ID包含UserFirstName的元素
    driver.findElement(By.cssSelector("input[id*='UserFirstName']")).sendKeys("sam");
    

• 添加显式等待：切换窗口后，页面元素可能还未完全渲染完成，添加显式等待确保元素可交互后再操作，避免因元素未加载导致的异常：

  WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
  WebElement firstNameInput = wait.until(ExpectedConditions.elementToBeClickable(By.name("UserFirstName")));
  firstNameInput.sendKeys("sam");
  

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