Java Selenium获取DuckDuckGo搜索自动补全span文本失败问题

核心错误原因 #

你代码跑不通是两个核心问题叠加导致的：

• 元素定位范围错误：你写的//div[contains(@class, 'acp')]会把所有class带acp字样的元素全选，包括外层的acp-wrap容器、底部的acp-footer栏，这些元素内部没有补全内容，遍历查找子span时自然抛出NoSuchElementException。另外你写的选择器存在语法错误：By.className()传参不能带.前缀，css选择器匹配类必须加.前缀，写By.cssSelector("t-normal")是查找名为t-normal的标签，根本不是匹配class为t-normal的元素。
• 执行时序错误：输入完关键词立刻查找元素时，自动补全的异步请求还没返回、DOM还没渲染完成，单纯依赖隐式等待稳定性极差，很容易在元素未加载完成时拿到空结果。你在浏览器控制台能跑通选择器，是因为手动执行代码时补全列表已经渲染完了，和代码执行的时序完全不一样。

可直接运行的修正代码 #

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;
import java.util.List;
// Selenium 3.x版本额外导入这个包
// import java.util.concurrent.TimeUnit;

public class DuckDuckGoAutocompleteTest {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        // Selenium 4.x 隐式等待写法
        driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));
        // Selenium 3.x 隐式等待写法
        // driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        
        driver.get("https://start.duckduckgo.com/");
        WebElement searchText = driver.findElement(By.name("q"));
        searchText.sendKeys("elephant");
        
        // 显式等待补全项加载完成，比单纯隐式等待稳定
        WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(3));
        List<WebElement> searchList = wait.until(ExpectedConditions.presenceOfAllElementsLocatedBy(
                By.cssSelector("div.acp[data-index]")
        ));

        for (WebElement suggestItem : searchList) {
            // 直接取div文本即可，会自动拼接内部所有可见文本，就是完整建议词
            System.out.println("自动补全建议：" + suggestItem.getText().trim());
        }

        driver.quit();
    }
}

注意：代码默认给出Selenium 4写法，如果你用适配Java 8的Selenium 3版本，按照注释替换成TimeUnit写法即可，核心逻辑完全一致。

关键说明 #

• 定位补全项时用div.acp[data-index]作为css选择器，精准匹配带data-index属性的补全项div，不会把外层无关容器选进来。
• 不需要额外查找内部的t-normalspan：补全项div的getText()方法会自动返回节点下所有可见文本，不管文本在span里还是直接在div下，刚好是完整的搜索建议内容，少一层查找就少一层出错概率。
• 不要用模糊匹配class的方式找动态渲染的组件，优先用元素独有的属性（比如这里的data-index）做定位，稳定性高很多。
• 如果在控制台验证选择器可用但代码里找不到元素，90%都是执行时机不对，加显式等待等元素渲染完成再操作即可，不要盲目换选择器。

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