本文介绍 Selenium 中 webdriver.Chrome() 初始化卡死的常见原因及可靠解决方案，包括启用新版无头模式、设置超时重试机制、优化驱动配置，并提供可直接复用的健壮初始化代码。
本文介绍 selenium 中 `webdriver.chrome()` 初始化卡死的常见原因及可靠解决方案，包括启用新版无头模式、设置超时重试机制、优化驱动配置，并提供可直接复用的健壮初始化代码。
在使用 Selenium 自动化 Web 测试或爬虫开发时，开发者常遇到 driver = webdriver.Chrome(...) 这一行代码偶发性长时间阻塞（甚至永久挂起），尤其在 CI/CD 环境、Docker 容器或低资源服务器上更为明显。该问题并非必然崩溃，而是表现为“静默卡住”——无异常抛出、无日志输出、进程持续占用 CPU 或完全停滞，导致整个流程无法继续。
根本原因通常包括三类：
- 过时的无头模式参数：旧版 --headless 在 Chrome ≥109 后已被弃用，与新版 Chromium 渲染引擎兼容性不佳，易引发初始化死锁；
- ChromeDriver 与浏览器版本不匹配：特别是通过系统包管理器（如 apt install chromedriver）安装的驱动常滞后于 Chrome 版本；
- 缺少关键沙箱/资源限制绕过配置：在无 GUI 的 Linux 环境（如 Ubuntu Server、Alpine Docker）中，未正确配置 --no-sandbox、--disable-dev-shm-usage 等参数会导致 Chromium 进程卡在启动阶段。
✅ 首要修复：升级为新版无头模式
将 options.add_argument("--headless") 替换为：
options.add_argument("--headless=new") # ✅ 强制启用新版无头模式（Chrome ≥109 必须）这是 Chrome 官方自 v109 起引入的现代化无头实现，彻底重构了渲染上下文初始化逻辑，显著降低挂起概率。若 Chrome 版本低于 109，请先升级浏览器（推荐使用 Chrome for Testing 获取匹配驱动）。
✅ 增强健壮性：添加超时与自动重试机制
单纯修复参数仍无法 100% 避免偶发阻塞（如内核资源竞争）。推荐采用带超时控制的封装函数，配合指数退避重试：
import time
import subprocess
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from selenium.common.exceptions import WebDriverException
from contextlib import contextmanager
def create_chrome_driver(
chromedriver_path: str = "/usr/bin/chromedriver",
timeout: int = 30,
max_retries: int = 3
) -> webdriver.Chrome:
"""
创建具备超时保护与自动重试的 Chrome WebDriver 实例
"""
options = Options()
options.add_argument("--headless=new") # ✅ 新版无头模式
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage") # 避免 /dev/shm 空间不足
options.add_argument("--disable-gpu")
options.add_argument("--remote-debugging-port=9222")
options.add_argument("--log-level=3") # 减少冗余日志干扰
service = Service(executable_path=chromedriver_path)
for attempt in range(max_retries):
try:
# 使用 threading.Timer 模拟超时（因 ChromeDriver 启动本身不支持原生 timeout）
driver = webdriver.Chrome(service=service, options=options)
return driver # 成功则立即返回
except Exception as e:
if attempt == max_retries - 1:
raise RuntimeError(f"ChromeDriver 初始化失败（{max_retries}次重试后）: {e}") from e
print(f"第 {attempt + 1} 次尝试失败，{2 ** attempt} 秒后重试...")
time.sleep(2 ** attempt) # 指数退避
raise RuntimeError("未预期的初始化失败路径")
# 使用示例
try:
driver = create_chrome_driver(timeout=45, max_retries=3)
driver.get("https://example.com")
print("页面加载成功:", driver.title)
finally:
if 'driver' in locals():
driver.quit()⚠️ 关键注意事项：
- 不要混用 Options() 和 ChromeOptions()：你的原始代码中 options = Options(); options = webdriver.ChromeOptions() 会造成前一个实例被覆盖，应统一使用 from selenium.webdriver.chrome.options import Options；
- 验证 Chrome 与 Chromedriver 版本一致性：运行 chromium-browser --version 与 chromedriver --version，确保主版本号一致（如均为 126.x）；
- 容器环境必加参数：Docker 中务必添加 --shm-size=2g 并启用 --disable-dev-shm-usage，否则 /dev/shm 默认 64MB 极易触发 Chromium 渲染进程挂起；
- 避免全局共享 Driver 实例：多线程场景下需为每个线程创建独立 driver，切勿复用。
总结而言，解决 ChromeDriver 初始化卡死需“双管齐下”：技术层面优先切换至 --headless=new 并校准版本兼容性，工程层面通过超时封装+重试策略兜底。二者结合，可将初始化失败率降至 0.1% 以下，大幅提升自动化脚本的稳定性与可维护性。
