ChromeDriver主版本号必须与Chrome浏览器主版本号一致,否则必然报错;需实测Chrome版本(如chrome://version或命令行),下载对应驱动,推荐用webdriver-manager自动管理或显式指定Service路径,并在CI/CD中统一Chrome与驱动版本。

直接结论:ChromeDriver主版本号必须与Chrome浏览器主版本号一致,不一致就必然报错,没有例外。
查当前Chrome浏览器版本的三种可靠方式
别信“我刚装的最新版”,得实测。错误常源于你本地Chrome已静默升级到126,而驱动还卡在124。
- 图形界面最快:打开Chrome,地址栏输入
chrome://version,看第一行“Google Chrome”后的完整版本号,例如126.0.6478.127,主版本是126 - Windows命令行(免开浏览器):
wmic datafile where name="C:\Program Files\Google\Chrome\Application\chrome.exe" get Version /value - macOS/Linux终端:
/Applications/Google Chrome.app/Contents/MacOS/Google Chrome --version或google-chrome --version
下载匹配的ChromeDriver不能只看官网首页
ChromeDriver官网(https://chromedriver.chromium.org)首页只列最新版,但你的Chrome可能是旧稳定版(比如125),盲目下126版驱动会报错。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 必须访问
https://chromedriver.chromium.org/downloads页面,往下翻,找和你Chrome主版本号完全一致的那一栏 - 注意区分
Chrome for Testing渠道:自Chrome 115起,官方推荐用这个专用测试版,它的版本号和驱动映射更干净,下载页有独立入口 - 下载后解压得到的二进制文件名就是
chromedriver(macOS/Linux)或chromedriver.exe(Windows),别误点源码包或符号表
让Selenium找到驱动的两种写法,别再硬编码路径
写死 executable_path='/xxx/chromedriver' 是早期写法,现在极易出错,尤其跨机器部署时。
立即学习“Python免费学习笔记(深入)”;
- 推荐用
service+options分离管理(Selenium 4+ 标准写法):from selenium import webdriver from selenium.webdriver.chrome.service import Service from selenium.webdriver.chrome.options import Options <p>options = Options() options.add_argument('--headless') # 可选 service = Service('/path/to/chromedriver') # 路径指向你刚下载的文件 driver = webdriver.Chrome(service=service, options=options) - 更省心的办法:用
webdriver-manager自动处理版本和路径from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager <p>driver = webdriver.Chrome( service=Service(ChromeDriverManager().install()) )
它会在首次运行时自动检测Chrome版本、下载对应驱动、缓存到本地,后续直接复用
CI/CD或多人协作环境里最容易被忽略的一点
很多人解决了本地问题,一上Jenkins或Docker就又报错——因为服务器上Chrome版本和开发机根本不同。
- 不要假设CI机器装了Chrome,先确认:
google-chrome --version或which google-chrome - Docker中务必显式安装指定版本Chrome,例如Debian系用:
apt-get install -y google-chrome-stable=126.0.6478.127-1,再配同版本驱动 - Chrome for Testing 是CI首选:它不带UI、无自动更新、版本发布节奏稳定,下载地址统一且可预测


















