Selenium搭配ChromeDriver使用时如何修复TimeoutException超时错误？

Hey there! As someone who’s stumbled through plenty of Selenium timeout headaches early on, let’s figure this out together. The timeout you’re seeing is likely because Selenium’s default behavior waits for every single resource on the page to load—including those slow-loading ads you mentioned. Here are practical fixes you can try right now:

1. 调整页面加载策略，跳过不必要的资源加载 #

Selenium默认的normal加载策略会等待所有资源（图片、广告、脚本）加载完成，这很容易超时。你可以改成只等待DOM结构加载完成：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# 可选值：'eager'（等待DOMContentLoaded事件）或 'none'（完全不等待页面加载）
chrome_options.page_load_strategy = 'eager'

driver = webdriver.Chrome(options=chrome_options)
driver.get("你的目标URL")

eager是比较稳妥的选择——它会等页面的核心DOM加载完成，不用管还在加载的广告或图片。

2. 用显式等待代替全局超时，针对关键元素等待 #

与其让Selenium傻等整个页面，不如告诉它“等我需要的元素出现就继续”。这样即使广告还在加载，只要核心内容就绪，脚本就能往下走：

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import TimeoutException

driver = webdriver.Chrome()
driver.get("你的目标URL")

try:
    # 等待页面的关键元素（比如主内容区的ID）出现，最多等10秒
    WebDriverWait(driver, 10).until(
        EC.presence_of_element_located((By.ID, "main-content"))
    )
    print("核心元素加载完成，可以继续操作了！")
except TimeoutException:
    print("关键元素加载超时，但页面可能已经可用，可根据情况继续或终止")

你需要把By.ID, "main-content"换成你实际页面中存在的关键元素定位器（比如类名、XPath都可以）。

3. 禁用广告加载，从根源减少超时概率 #

如果广告确实是拖慢加载的元凶，你可以让Chrome自动阻止广告：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# 设置Chrome偏好，阻止广告加载
prefs = {"profile.managed_default_content_settings.ads": 2}
chrome_options.add_experimental_option("prefs", prefs)

driver = webdriver.Chrome(options=chrome_options)
driver.get("你的目标URL")

这个设置会让Chrome内置的广告拦截器生效，减少页面需要加载的资源数量。

4. 检查隐式等待的冲突 #

如果你之前设置了driver.implicitly_wait()，同时又用了显式等待，可能会导致等待时间叠加，反而更容易超时。建议新手优先用显式等待，隐式等待可以暂时注释掉，避免冲突。

先从调整页面加载策略和显式等待开始试，这两个方法最直接，也最适合新手快速解决问题！

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