使用ChromeDriver下载Excel文件时遭遇NoSuchElementException与TimeoutException

核心问题分析 #

1. 绝对XPATH过于脆弱：你使用的/html/body/div[1]/div[3]/...这类绝对路径完全依赖页面DOM层级结构，只要页面有微小变动（比如新增元素、布局调整）就会失效，直接触发NoSuchElementException。
2. 固定等待不可靠：time.sleep()是硬编码时长等待，无法适配页面实际加载速度，常出现元素未渲染完成就执行操作的情况，进而引发超时或元素找不到的异常。
3. 未处理元素可见性：目标元素可能不在当前视图范围内，直接点击会失败；或者存在加载动画、遮挡层干扰交互。

解决方案步骤 #

1. 替换为稳定的相对XPATH #

放弃绝对路径，改用基于元素文本或属性的相对定位，确保定位逻辑不受页面层级变动影响：

# 基于文本内容定位（优先推荐，适配文本格式变动）
By.XPATH, "//div[normalize-space(text())='Key Fund Documents']"
# 结合父元素属性缩小范围（更精准）
By.XPATH, "//ul[contains(@class,'nav-tabs')]/li[3]/div[text()='Key Fund Documents']"

normalize-space()用于清除文本中的空格、换行，避免因格式问题匹配失败。

2. 用显式等待替代固定sleep #

通过WebDriverWait等待元素状态满足条件后再操作，确保元素完全渲染：

# 等待Cookie同意按钮并点击
cookie_btn = WebDriverWait(driver, 20).until(
    EC.element_to_be_clickable((By.ID, 'truste-consent-button'))
)
cookie_btn.click()

# 等待目标元素出现并滚动到可见区域
target_element = WebDriverWait(driver, 20).until(
    EC.presence_of_element_located((By.XPATH, "//div[normalize-space(text())='Key Fund Documents']"))
)
driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", target_element)

# 等待元素可点击后执行点击
WebDriverWait(driver, 10).until(
    EC.element_to_be_clickable((By.XPATH, "//div[normalize-space(text())='Key Fund Documents']"))
).click()

3. 处理交互异常情况 #

如果仍无法点击，可尝试以下两种方式：

• JavaScript强制点击：绕过元素可见性或交互限制

driver.execute_script("arguments[0].click();", target_element)

• 检查iframe嵌套：若目标元素在iframe内，需先切换到iframe再定位：

# 替换为实际iframe的定位属性（id/name/xpath等）
iframe = WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.ID, 'target-iframe')))
driver.switch_to.frame(iframe)
# 之后再执行元素定位与点击操作

修改后的完整代码 #

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

website = "https://www.northerntrust.com/united-kingdom/what-we-do/investment-management/pooled-funds"
driver = webdriver.Chrome(driver_location, options=chrome_options) 
enable_download_headless(driver, filepath_data)
driver.get(website)

# 处理Cookie同意弹窗
try:
    cookie_btn = WebDriverWait(driver, 20).until(
        EC.element_to_be_clickable((By.ID, 'truste-consent-button'))
    )
    cookie_btn.click()
except Exception as e:
    print(f"Cookie同意操作失败：{str(e)}")

# 定位并点击目标元素
try:
    target_element = WebDriverWait(driver, 20).until(
        EC.presence_of_element_located((By.XPATH, "//div[normalize-space(text())='Key Fund Documents']"))
    )
    # 滚动到元素可见区域
    driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", target_element)
    # 等待可点击后点击
    WebDriverWait(driver, 10).until(
        EC.element_to_be_clickable((By.XPATH, "//div[normalize-space(text())='Key Fund Documents']"))
    ).click()
    print("成功点击「Key Fund Documents」")
except Exception as e:
    print(f"点击操作失败：{str(e)}")
finally:
    driver.quit()

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