Python Selenium wait函数未抛出TimeoutException异常的问题咨询

可能诱因 #

• ChromeDriver与浏览器进程死锁：Chrome运行时遇到页面崩溃、内存溢出、JS死循环等场景时，会出现Driver与浏览器进程通信中断，wait对应的RPC请求一直收不到响应，不会触发预设的超时逻辑。你当前的配置未加进程异常自动退出相关参数，出现该问题的概率会明显升高。
• 版本兼容性bug：Selenium、Chrome、ChromeDriver三者跨大版本搭配时，会出现内置超时逻辑失效的问题，尤其是Chrome 100+版本搭配Selenium 3.x的环境，该类异常的上报量极高。
• 隐式等待与显式等待冲突：如果代码中同时设置了implicitly_wait隐式等待和WebDriverWait显式等待，两者的超时逻辑会叠加甚至出现内部计数异常，最终导致预设的超时阈值不生效。
• 页面加载策略默认配置问题：默认的页面加载策略为normal，会等待所有资源加载完成，遇到页面存在无法加载的静态资源（比如被限制访问的第三方统计脚本、CDN资源超时）时，页面加载状态会一直显示未完成，wait操作会被阻塞甚至跳过超时判断。
• 高日志等级掩盖底层异常：你的配置中--log-level=3仅输出致命错误，Driver和浏览器通信的超时、断连错误被完全屏蔽，无法感知底层异常的情况下会误以为是wait逻辑一直卡住。

可行解决方案 #

启动配置优化 #

在你现有启动配置的基础上新增以下参数：

options.add_argument('--disable-dev-shm-usage')
# 配置全局进程超时兜底，单位为毫秒
options.add_argument('--timeout=60000')
# 页面崩溃/无响应时自动终止进程，避免长时间卡住
options.add_argument('--disable-hang-monitor')
options.add_argument('--disable-extensions')
options.add_argument('--kill-on-bad-exit')
# 修改页面加载策略为eager，仅等待DOM加载完成，不等待静态资源加载
options.page_load_strategy = 'eager'

排查问题阶段可以临时把--log-level=3改为--log-level=1，方便复现问题时查看底层报错定位根因。

代码逻辑兜底 #

• 不要混用隐式等待和显式等待，全局仅保留显式WebDriverWait逻辑即可。
• 给wait逻辑套一层Python原生超时逻辑作为兜底，避免Selenium内部超时机制失效：

from functools import wraps
import time

def timeout(seconds):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            start_time = time.time()
            while time.time() - start_time < seconds:
                try:
                    return func(*args, **kwargs)
                except Exception:
                    time.sleep(0.5)
            raise TimeoutError(f"操作{seconds}秒超时")
        return wrapper
    return decorator

# 使用示例，超时时间比Selenium设置的50秒多5秒作为兜底
@timeout(55)
def wait_target_element(driver):
    return WebDriverWait(driver, 50).until(EC.presence_of_element_located((By.ID, 'target')))

• 增加定期巡检逻辑，检测到Chrome、ChromeDriver无响应时直接杀掉进程并重启Driver实例，避免任务长时间阻塞。

版本适配 #

确保Selenium、Chrome、ChromeDriver大版本匹配：

• Chrome 110+ 搭配 Selenium 4.8+
• Chrome 90~109 搭配 Selenium 4.0~4.7
• 完全避免Selenium 3.x搭配Chrome 100+的版本组合

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