1. 项目概述为什么一个驱动程序的版本如此关键做自动化测试或者网页数据抓取的朋友对chromedriver这个名字一定不陌生。它就像是连接你的自动化脚本比如 Selenium和 Chrome 浏览器之间的“翻译官”和“传令兵”。脚本说“点击这个按钮”chromedriver就负责把这个指令准确地传达给 Chrome 浏览器去执行。今天要聊的就是安装一个特定版本——115 版——的chromedriver并确认它兼容 Chrome 115 及 116 版本。这听起来像是个简单的下载动作但背后涉及的版本匹配、环境配置和故障排查往往是新手甚至老手都会踩坑的地方。我经历过无数次因为版本不匹配导致的脚本突然“瘫痪”浏览器打不开或者元素找不到调试半天才发现是驱动没对上。所以这个“安装”动作远不止是下载一个文件那么简单它关乎整个自动化项目的稳定基石。标题里特意提到了“经检验116也可以使用”这是一个非常宝贵的经验信息。官方通常要求严格版本对应但在实际中相邻的小版本有时会有兼容性窗口这个信息能帮我们避免在 Chrome 自动升级到 116 后手忙脚乱。本文将彻底拆解如何精准、稳定地完成chromedriver 115的部署并深入探讨版本兼容背后的逻辑、不同系统下的安装路径奥秘、以及如何构建一个健壮的、能应对浏览器升级的自动化环境。无论你是刚入门自动化测试还是正在搭建爬虫环境这篇从实战中总结的指南都能让你少走弯路。2. 核心原理与版本兼容性深度解析2.1 Chromedriver 与 Chrome 的通信协议为何必须版本匹配要理解为什么版本如此重要得先看看它们是怎么工作的。Chrome 浏览器有一套内部用于远程控制和调试的协议叫做Chrome DevTools Protocol。Chromedriver的核心作用就是接收来自 Selenium WebDriver 的标准指令如find_element,click然后将这些指令“翻译”成 CDP 协议命令发送给 Chrome。随着 Chrome 版本的更新CDP 协议本身可能会增加新的能力、修改某些命令的格式或行为。因此新版本的chromedriver实现了对新版 CDP 协议的支持。如果使用过旧的chromedriver连接新版的 Chrome可能会出现chromedriver发送了一个 Chrome 已经不再支持或格式已变的命令导致通信失败典型报错如This version of ChromeDriver only supports Chrome version XX。反之用太新的chromedriver连接旧版 Chrome则可能发送了旧版浏览器无法理解的指令。所以严格的一一对应是最理想、最稳定的状态。2.2 “版本 115 兼容 116”的现象与风险评估那么标题中提到的“116也可以使用”如何解释这通常发生在 Chrome 两个相邻的小版本之间。Chrome 的版本迭代非常迅速但 CDP 协议并非每个小版本都会发生破坏性变更。在 115 到 116 这样的迭代中可能主要修复了一些 bug 或增加了非核心的新特性而核心的自动化指令集保持兼容。因此chromedriver 115有可能依然能与Chrome 116正常通信。注意这是一种“可能可行”的状态而非官方保证。依赖这种兼容性存在风险不确定性并非所有 115-116 的组合都一定兼容。取决于具体的构建和更新内容。功能缺失116 版本浏览器中新增的某些自动化特性115 的驱动可能无法调用。潜在的不稳定可能会遇到一些难以复现的偶发性错误。 因此这可以作为一个临时的应急方案或已知兼容的特定环境配置但在生产环境中长期最佳实践仍然是保持驱动与浏览器版本的严格同步。2.3 获取准确版本信息的实战技巧在开始安装前首要任务是精确查明你当前系统中 Chrome 浏览器的版本。这里有几个比简单查看“关于”更实用的方法通过命令行精准查询推荐对于 Windows 用户打开命令提示符或 PowerShell对于 macOS 或 Linux 用户打开终端。Windows: 执行“C:\Program Files\Google\Chrome\Application\chrome.exe” --version注意路径中的引号。macOS: 执行/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version。Linux: 执行google-chrome --version或chromium-browser --version。命令行返回的结果如Google Chrome 115.0.5790.102其中的115就是主版本号这是我们寻找对应chromedriver的关键。通过浏览器自动化查询自身版本程序化方法如果你已经在写自动化脚本甚至可以用一段简单的 Python 脚本来获取版本这对于后续自动下载对应驱动非常有帮助import subprocess import re def get_chrome_version(): try: # Windows 示例 result subprocess.run([reg, query, HKEY_CURRENT_USER\\Software\\Google\\Chrome\\BLBeacon, /v, version], capture_outputTrue, textTrue, shellTrue) if result.returncode 0: match re.search(rversion\sREG_SZ\s(\d\.\d\.\d\.\d), result.stdout) if match: return match.group(1) except Exception: pass # 如果注册表查询失败尝试通用命令行方法需要根据系统调整命令 # ... 此处可添加其他系统的命令 return None这段代码尝试从 Windows 注册表中读取 Chrome 的精确版本比解析命令行输出更稳定。3. 分步安装与配置全攻略3.1 官方与镜像源下载选择下载chromedriver的首选地址是它的官方下载站点https://chromedriver.chromium.org/downloads。页面会列出所有历史版本。找到 “ChromeDriver 115.0.5790.102” 版本号会变这一类的链接点击进入下载页。实操心得应对官方访问困难由于网络原因直接访问官方下载链接可能速度缓慢甚至失败。这时国内镜像源是更高效的选择。例如淘宝的 NPM 镜像也提供了chromedriver的备份https://npm.taobao.org/mirrors/chromedriver/在这个镜像站中目录结构非常清晰按照版本号组织你可以直接进入/115.0.5790.102/这样的目录下载对应操作系统的压缩包。使用镜像源时务必核对文件完整性对比文件大小或使用校验和这是基本的安全操作。3.2 多平台安装与路径配置详解下载到的是一个压缩包Windows 是.zip macOS/Linux 是.tar.gz解压后得到一个可执行文件chromedriver.exe(Windows) 或chromedriver(macOS/Linux)。核心操作将其放在系统PATH环境变量包含的目录中。这是为了让系统在任何位置都能找到并执行它。Windows 系统配置解压将chromedriver.exe解压到一个你计划永久存放的目录例如D:\AutomationTools\。切忌放在临时下载文件夹或桌面。获取路径在文件资源器中进入该目录在地址栏点击一下即可复制完整路径如D:\AutomationTools。修改系统环境变量右键点击“此电脑” - “属性” - “高级系统设置” - “环境变量”。在“系统变量”部分找到并选中Path变量点击“编辑”。点击“新建”将复制的路径D:\AutomationTools粘贴进去。重要顺序确保将这个新建项通过“上移”按钮移动到列表的靠前位置因为系统会按顺序查找。验证打开一个新的命令提示符重要必须新开输入chromedriver --version。如果正确显示版本信息如ChromeDriver 115.0.5790.102则配置成功。macOS / Linux 系统配置解压并移动至标准目录打开终端执行以下命令。# 解压下载的压缩包 tar -xzf chromedriver_mac64.zip # macOS 示例 # 将 chromedriver 移动到 /usr/local/bin这是一个常见的用户级可执行文件目录 sudo mv chromedriver /usr/local/bin/ # 如果需要赋予可执行权限通常解压后已有但确保一下 sudo chmod x /usr/local/bin/chromedriver验证在终端中执行chromedriver --version查看输出。注意事项权限与路径冲突macOS 安全性首次在 macOS 上运行时可能会被系统阻止。需要进入“系统偏好设置”-“安全性与隐私”-“通用”点击“仍要允许”。路径优先级如果系统中有多个chromedriver例如通过 Homebrew 也安装了一个终端会执行which chromedriver命令显示的那个。确保你刚配置的路径优先级最高。3.3 在自动化脚本中指定驱动路径更佳实践将驱动放入PATH是通用方法但在团队协作或复杂环境中更推荐在代码中显式指定驱动路径这样可以避免环境差异带来的问题。Python Selenium 示例from selenium import webdriver from selenium.webdriver.chrome.service import Service # 定义 chromedriver 的绝对路径 driver_path rD:\AutomationTools\chromedriver.exe # Windows # driver_path /usr/local/bin/chromedriver # macOS/Linux # 创建 Service 对象 service Service(executable_pathdriver_path) # 创建浏览器选项可选 options webdriver.ChromeOptions() # 可以添加各种选项如无头模式、忽略证书错误等 # options.add_argument(--headless) # 无头模式 # options.add_argument(--ignore-certificate-errors) # 传入 service 和 options 创建驱动实例 driver webdriver.Chrome(serviceservice, optionsoptions) try: driver.get(https://www.baidu.com) print(driver.title) finally: driver.quit()使用Service对象是 Selenium 4 及以上版本推荐的方式Selenium 3 的写法已弃用。这种方式将驱动路径与代码逻辑绑定项目迁移时只需同步驱动文件可靠性极高。4. 验证安装与兼容性测试实战安装配置完成后必须进行验证确保驱动不仅能运行还能与你的 Chrome 浏览器正确协作。4.1 基础功能验证脚本编写一个简单的测试脚本完成以下任务打开浏览器。访问一个已知网页。执行一个简单操作如获取标题、查找元素。正常关闭浏览器。from selenium import webdriver from selenium.webdriver.chrome.service import Service from selenium.webdriver.common.by import By import time def test_chromedriver(): driver_path 你的chromedriver绝对路径 service Service(driver_path) # 为了测试兼容性可以暂时不加任何options使用最纯净的状态 driver webdriver.Chrome(serviceservice) try: # 测试1浏览器能否正常启动并打开网页 test_url https://www.example.com driver.get(test_url) time.sleep(2) # 简单等待页面加载生产环境应用显式等待WebDriverWait # 测试2能否获取页面基本信息 print(f当前页面标题: {driver.title}) print(f当前页面URL: {driver.current_url}) # 测试3能否进行基本的元素查找查找页面中的h1标签 try: h1_element driver.find_element(By.TAG_NAME, h1) print(f找到 h1 元素内容: {h1_element.text[:50]}...) # 打印前50字符 except Exception as e: print(f查找元素测试未通过可能页面无h1: {e}) print(\n基础功能测试通过Chromedriver 工作正常。) except Exception as e: print(f\n测试过程中发生错误: {e}) # 这里可以添加更详细的错误日志记录 finally: # 确保浏览器被关闭避免残留进程 driver.quit() if __name__ __main__: test_chromedriver()运行这个脚本如果能够无错误地执行完毕并打印出页面信息说明chromedriver安装和基础功能是正常的。4.2 针对“Chrome 116”的专项兼容性测试为了验证标题中提到的“116也可以使用”我们需要设计一个针对性测试。核心思路是在 Chrome 116 浏览器环境下使用 chromedriver 115 执行一系列核心自动化操作检查是否存在功能异常或错误。from selenium import webdriver from selenium.webdriver.chrome.service import Service from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC import traceback def test_compatibility_with_chrome116(): 测试 chromedriver 115 对 Chrome 116 的兼容性。 前提请确保你的系统默认Chrome已是116版本。 driver_path 你的chromedriver 115绝对路径 service Service(driver_path) # 获取当前浏览器版本通过浏览器能力 options webdriver.ChromeOptions() # 添加参数让浏览器启动时打印更多信息可选 options.add_argument(--verbose) # 也可以指定浏览器二进制路径如果你安装了多个版本 # options.binary_location rC:\Program Files\Google\Chrome\Application\chrome.exe driver webdriver.Chrome(serviceservice, optionsoptions) # 通过CDP获取浏览器版本更可靠 version_info driver.capabilities[browserVersion] print(f连接的浏览器版本: {version_info}) if 116 not in version_info: print(警告当前浏览器主版本可能不是116兼容性测试结论可能不准确。) test_cases_passed 0 total_test_cases 4 try: # 测试用例1复杂页面加载与JavaScript执行 print(\n[测试1] 加载复杂单页应用(SPA)...) driver.get(https://angular.io) # 或任何一个你熟悉的复杂JS站点 wait WebDriverWait(driver, 10) # 等待某个特定元素出现证明JS执行成功 wait.until(EC.presence_of_element_located((By.CSS_SELECTOR, aio-shell))) print( 通过复杂SPA加载成功。) test_cases_passed 1 # 测试用例2表单交互 print(\n[测试2] 表单输入与提交...) driver.get(https://httpbin.org/forms/post) textarea driver.find_element(By.TAG_NAME, textarea) test_text 兼容性测试输入 textarea.send_keys(test_text) # 简单验证输入内容 if textarea.get_attribute(value) test_text: print(f 通过表单输入功能正常。) test_cases_passed 1 else: print( 失败表单输入内容不匹配。) # 测试用例3弹窗与对话框处理 print(\n[测试3] JavaScript弹窗处理...) driver.get(https://the-internet.herokuapp.com/javascript_alerts) alert_button driver.find_element(By.XPATH, //button[contains(text(),Click for JS Alert)]) alert_button.click() alert driver.switch_to.alert alert_text alert.text alert.accept() # 接受弹窗 print(f 通过成功处理JS Alert文本为{alert_text}。) test_cases_passed 1 # 测试用例4Cookie与本地存储操作常用API print(\n[测试4] Cookie操作...) driver.get(https://www.example.com) driver.add_cookie({name: test_cookie, value: 12345}) get_cookie driver.get_cookie(test_cookie) if get_cookie and get_cookie[value] 12345: print(f 通过Cookie设置与读取正常。) test_cases_passed 1 else: print( 失败Cookie操作异常。) except Exception as e: print(f\n!!! 兼容性测试过程中出现异常: {e}) traceback.print_exc() # 打印详细错误栈便于定位 finally: driver.quit() print(f\n 兼容性测试总结 ) print(f测试用例通过率: {test_cases_passed}/{total_test_cases}) if test_cases_passed total_test_cases: print(结论在当前环境下Chromedriver 115 与 Chrome 116 基本功能兼容性良好。) else: print(结论发现兼容性问题建议升级至 Chromedriver 116 以获得最佳稳定性。) if __name__ __main__: test_compatibility_with_chrome116()这个测试脚本模拟了真实自动化项目中常见的几种操作场景。如果所有测试用例都能通过那么你就可以相对有信心地在Chrome 116环境下暂时继续使用chromedriver 115。但务必关注测试日志特别是那些非功能性的错误。5. 高级管理与故障排查实录5.1 使用驱动管理工具推荐给高级用户和团队手动管理驱动版本在多个项目或频繁更新的环境中非常繁琐。使用第三方库可以自动化这个过程。Python:webdriver-manager库这是目前最流行的解决方案。它会自动检测你本地安装的 Chrome 版本并下载匹配的chromedriver。from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager # 自动下载、缓存并返回正确的驱动路径 service Service(ChromeDriverManager().install()) driver webdriver.Chrome(serviceservice)第一次运行时会下载驱动之后会使用缓存。它极大简化了版本管理但需要注意其下载源在国内的访问速度。实操心得为 webdriver-manager 配置镜像源可以通过环境变量来加速下载import os os.environ[WDM_SSL_VERIFY] 0 # 如果需要忽略SSL验证不推荐生产环境 os.environ[WDM_PROGRESS_BAR] 0 # 关闭进度条 # 设置镜像源以淘宝镜像为例注意镜像源地址可能需要更新 os.environ[WDM_CHROMEDRIVER_URL] https://npm.taobao.org/mirrors/chromedriver/但请注意webdriver-manager的内部逻辑可能会变镜像源配置不一定始终有效。最稳定的方式还是直接手动下载并指定路径。5.2 典型错误与排查清单即使按照步骤操作你也可能会遇到问题。下面是一个快速排查清单错误现象可能原因排查步骤与解决方案WebDriverException: Message: unknown error: cannot find Chrome binary1. Chrome未安装。2. Chrome安装在了非标准路径。3. 通过options.binary_location指定的路径错误。1. 检查Chrome是否已安装。2. 在代码中通过options.binary_location显式指定Chrome可执行文件的完整绝对路径。SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version XX驱动与浏览器版本不匹配。这是最常见错误。1. 运行chrome --version和chromedriver --version核对主版本号。2. 前往官方或镜像站下载对应版本的驱动。3. 考虑使用webdriver-manager自动管理。WebDriverException: Message: ‘chromedriver’ executable needs to be in PATH.系统在PATH环境变量中找不到chromedriver。1. 确认chromedriver文件是否已放在PATH目录中。2.重启终端或IDE环境变量更改需要在新会话中生效。3. 在代码中使用Service(executable_path‘绝对路径’)显式指定。浏览器闪退或无法启动1. 驱动文件损坏。2. 浏览器正在运行端口冲突。3. 杀毒软件或防火墙拦截。1. 重新下载驱动文件。2. 关闭所有Chrome进程后再运行脚本。3. 暂时禁用杀毒软件或防火墙测试或将驱动加入白名单。元素找不到或操作超时但浏览器已打开1. 页面加载未完成就执行操作。2. 使用了不正确的定位器。3. 元素在iframe或shadow DOM内。1. 使用WebDriverWait进行显式等待而不是time.sleep。2. 使用浏览器开发者工具检查元素确认定位器如XPath、CSS Selector的准确性。3. 如需操作iframe内元素先使用driver.switch_to.frame()切换上下文。5.3 构建版本兼容的稳健自动化环境对于追求稳定性的生产环境我个人的最佳实践是锁定浏览器版本在自动化测试服务器或爬虫服务器上禁用 Chrome 浏览器的自动更新。这样可以确保环境版本固定从根源上避免驱动不匹配。Windows: 使用组策略或修改注册表禁用 Google Update 服务。macOS/Linux: 通过包管理器安装特定版本并锁定该版本。驱动与代码一起版本化将对应版本的chromedriver二进制文件放入项目的代码仓库中例如tools/drivers/目录。在代码中通过相对路径引用它。这样任何拉取代码的人都能获得完全一致的环境。import sys import os # 根据当前操作系统决定驱动文件名和路径 if sys.platform.startswith(win): driver_name chromedriver.exe elif sys.platform.startswith(darwin): driver_name chromedriver_mac64 else: driver_name chromedriver_linux64 driver_path os.path.join(os.path.dirname(__file__), tools, drivers, driver_name)在 CI/CD 流水线中预先安装如果使用 Jenkins、GitLab CI 等将安装固定版本 Chrome 和对应chromedriver的步骤写入 Pipeline 脚本确保每次构建环境都是全新的、一致的。安装一个特定版本的chromedriver并处理好它与 Chrome 浏览器版本之间的“暧昧关系”是自动化工作流中看似基础却至关重要的一环。手动下载配置是基本功理解版本兼容性原理能让你在出问题时快速定位而采用驱动管理工具或环境锁定策略则是迈向稳健自动化生产环境的关键一步。记住标题中“116也可以使用”是经验之谈给了我们一个缓冲带但绝不是长期依赖的借口。定期检查并更新你的驱动让“翻译官”和“浏览器”保持流畅沟通你的自动化脚本才能稳定高效地运行下去。