Ubuntu下Chromedriver与Chrome版本匹配安装指南-代码聚汇网

Ubuntu下Chromedriver与Chrome版本匹配安装指南

Necromanov

1. 项目背景与需求解析

在Ubuntu系统上使用Selenium进行自动化测试时，Chromedriver是不可或缺的关键组件。作为连接Selenium测试脚本和Chrome浏览器的桥梁，Chromedriver版本必须与已安装的Chrome浏览器版本严格匹配。然而在实际操作中，很多开发者都会遇到以下典型问题：

通过apt-get安装的Chromedriver版本往往滞后于Chrome浏览器版本
手动下载的Chromedriver文件需要正确配置执行权限和路径
不同Linux发行版对二进制文件的存放位置有不同规范
自动化部署时需要确保版本匹配的可靠性

我最近在为某电商项目搭建自动化测试环境时，就遇到了Chromedriver 115版本与Chrome 116版本不兼容导致测试用例集体失败的情况。经过多次实践，总结出一套在Ubuntu上安装最新版Chromedriver的可靠方法。

2. 环境准备与前置检查

2.1 确认当前Chrome浏览器版本

在开始安装前，必须首先确认系统已安装的Chrome浏览器版本。在终端执行：

bash复制google-chrome --version

典型输出示例：

code复制Google Chrome 116.0.5845.96

记录下这个版本号（本例中为116.0.5845.96），这将决定我们需要下载哪个版本的Chromedriver。

注意：如果提示"google-chrome: command not found"，说明尚未安装Chrome浏览器，需要先通过以下命令安装：
bash复制wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb

2.2 检查现有Chromedriver状态

运行以下命令检查是否已安装Chromedriver及其版本：

bash复制chromedriver --version

如果系统已安装旧版Chromedriver，建议先卸载以避免冲突：

bash复制sudo apt remove chromedriver

3. 获取匹配的Chromedriver版本

3.1 确定下载URL

Chromedriver的官方下载地址遵循固定格式：

code复制https://chromedriver.storage.googleapis.com/{VERSION}/chromedriver_linux64.zip

其中{VERSION}需要替换为与Chrome浏览器匹配的版本号。但这里有个关键细节：Chromedriver的主版本号（第一个数字）必须与Chrome完全一致，但后续版本号不需要精确匹配。

以Chrome 116.0.5845.96为例：

访问 https://chromedriver.storage.googleapis.com/LATEST_RELEASE_116
页面将返回该分支的最新版本号（如116.0.5845.59）

组合出完整下载URL：

code复制https://chromedriver.storage.googleapis.com/116.0.5845.59/chromedriver_linux64.zip

3.2 自动化获取最新版本

对于需要频繁更新的场景，可以使用以下脚本自动获取匹配版本：

bash复制CHROME_VERSION=$(google-chrome --version | awk '{print $3}')
CHROMEDRIVER_VERSION=$(curl -s "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_${CHROME_VERSION%.*}")
echo "匹配的Chromedriver版本: $CHROMEDRIVER_VERSION"

4. 安装与配置流程

4.1 下载并解压Chromedriver

执行以下命令完成下载安装：

bash复制# 创建专用目录
mkdir -p ~/chromedriver

# 下载并解压
wget -O ~/chromedriver/chromedriver.zip "https://chromedriver.storage.googleapis.com/$CHROMEDRIVER_VERSION/chromedriver_linux64.zip"
unzip ~/chromedriver/chromedriver.zip -d ~/chromedriver/

# 设置执行权限
chmod +x ~/chromedriver/chromedriver

4.2 配置系统路径

有三种方式将Chromedriver加入系统PATH：

方式1：临时生效（仅当前会话）

bash复制export PATH=$PATH:~/chromedriver

方式2：永久生效（对当前用户）
在~/.bashrc文件末尾添加：

bash复制export PATH=$PATH:~/chromedriver

然后执行：

bash复制source ~/.bashrc

方式3：系统级安装（推荐）

bash复制sudo mv ~/chromedriver/chromedriver /usr/local/bin/

4.3 验证安装

运行以下命令确认安装成功：

bash复制chromedriver --version

预期输出应显示与下载版本一致的版本号。

5. 自动化维护方案

5.1 自动更新脚本

创建update_chromedriver.sh脚本：

bash复制#!/bin/bash

# 获取当前Chrome版本
CHROME_VERSION=$(google-chrome --version | awk '{print $3}')

# 获取匹配的Chromedriver版本
CHROMEDRIVER_VERSION=$(curl -s "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_${CHROME_VERSION%.*}")

# 下载并安装
echo "正在安装Chromedriver $CHROMEDRIVER_VERSION..."
wget -q -O /tmp/chromedriver.zip "https://chromedriver.storage.googleapis.com/$CHROMEDRIVER_VERSION/chromedriver_linux64.zip"
sudo unzip -o /tmp/chromedriver.zip -d /usr/local/bin/
sudo chmod +x /usr/local/bin/chromedriver

# 验证
echo "当前Chromedriver版本:"
chromedriver --version

赋予执行权限并运行：

bash复制chmod +x update_chromedriver.sh
./update_chromedriver.sh

5.2 设置cron定时任务

每月自动检查更新：

bash复制(crontab -l 2>/dev/null; echo "0 0 1 * * $HOME/update_chromedriver.sh") | crontab -

6. 常见问题排查

6.1 版本不匹配错误

错误信息示例：

code复制SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version 114

解决方案：

确认Chrome浏览器版本
按照前述步骤下载匹配版本的Chromedriver
彻底重启所有Chrome进程：
```
bash复制pkill -f chrome
```

6.2 权限问题

错误信息：

code复制bash: /usr/local/bin/chromedriver: Permission denied