调用chromedriver_autoinstaller.install()报错：PATH中未找到Chrome可执行文件

问题场景 #

调用chromedriver_autoinstaller.install()时触发ValueError，完整报错堆栈如下：

chromedriver_autoinstaller.install()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/e/reports_automation/venv/lib/python3.10/site-packages/chromedriver_autoinstaller/__init__.py", line 21, in install
    chromedriver_filepath = utils.download_chromedriver(path, no_ssl)
  File "/home/e/reports_automation/venv/lib/python3.10/site-packages/chromedriver_autoinstaller/utils.py", line 269, in download_chromedriver
    chrome_version = get_chrome_version()
  File "/home/e/reports_automation/venv/lib/python3.10/site-packages/chromedriver_autoinstaller/utils.py", line 140, in get_chrome_version
    path = get_linux_executable_path()
  File "/home/e/reports_automation/venv/lib/python3.10/site-packages/chromedriver_autoinstaller/utils.py", line 196, in get_linux_executable_path
    raise ValueError("No chrome executable found on PATH")
ValueError: No chrome executable found on PATH

核心原因 #

错误本质是chromedriver_autoinstaller无法在系统PATH环境变量中找到Chrome浏览器的可执行文件，可能是以下情况之一：

• 系统未安装Chrome浏览器；
• Chrome已安装，但可执行文件所在目录未加入PATH；
• Chrome安装路径不在工具默认搜索范围内。

分步解决方案 #

1. 检查Chrome是否已安装 #

在终端执行命令验证：

google-chrome --version
# 或尝试
chrome --version

如果返回“command not found”，先安装Chrome：

• Debian/Ubuntu系列系统：

sudo apt update
sudo apt install google-chrome-stable

• RHEL/CentOS系列系统：

sudo dnf install https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm

2. 修复Chrome路径的PATH配置 #

若已安装Chrome但工具找不到，先定位Chrome可执行文件路径：

which google-chrome

如果输出为空，说明路径不在PATH中，需要添加：

• 临时生效（仅当前终端会话）：

export PATH=$PATH:/path/to/chrome/directory

替换/path/to/chrome/directory为实际路径，比如/usr/bin或/usr/local/bin。

• 永久生效（重启终端后生效）：
  编辑~/.bashrc（bash终端）或~/.zshrc（zsh终端），添加一行：

export PATH=$PATH:/path/to/chrome/directory

保存后执行以下命令让配置生效：

source ~/.bashrc
# 或对应zsh的命令
source ~/.zshrc

3. 手动指定Chrome路径（无需修改PATH） #

如果不想调整系统环境变量，可以在代码中手动指定Chrome可执行路径，绕过工具的自动搜索：

import chromedriver_autoinstaller.utils
import chromedriver_autoinstaller
from selenium import webdriver

# 替换为你的Chrome实际路径
chrome_exec_path = "/usr/bin/google-chrome"
# 从指定路径获取Chrome版本
chrome_version = chromedriver_autoinstaller.utils.get_chrome_version_from_executable(chrome_exec_path)
# 下载对应版本的chromedriver
chromedriver_path = chromedriver_autoinstaller.utils.download_chromedriver(chrome_version=chrome_version)

# 初始化webdriver
driver = webdriver.Chrome(executable_path=chromedriver_path)

4. 替代方案：换用webdriver-manager #

如果chromedriver_autoinstaller的自动识别逻辑不好用，可以切换到webdriver-manager，它能更灵活地定位Chrome：
先安装依赖：

pip install webdriver-manager

然后修改代码：

from selenium import webdriver
from webdriver_manager.chrome import ChromeDriverManager

driver = webdriver.Chrome(ChromeDriverManager().install())

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