Symfony Panther无法识别已安装的chromedriver问题咨询

问题复现 #

在Ubuntu系统、PHP 8.2环境下，已通过以下方式安装Chromedriver：

• composer require --dev dbrekelmans/bdi && vendor/bin/bdi detect drivers
• composer require dbrekelmans/bdi && vendor/bin/bdi detect drivers
• sudo snap install chromium --devmode

执行vendor/bin/bdi detect drivers显示安装成功：

[OK] chromedriver 123.0.6312.122 installed to drivers/chromedriver

但Symfony Panther始终在vendor/symfony/panther/src/ProcessManager/ChromeManager.php第92行抛出找不到驱动的异常：

at vendor/symfony/panther/src/ProcessManager/ChromeManager.php:92
     88▕         if ($binary = (new ExecutableFinder())->find('chromedriver', null, ['./drivers', './vendor/bin'])) {
     89▕             return $binary;
     90▕         }
     91▕
  ➜  92▕         throw new \RuntimeException('"chromedriver" binary not found. Install it using the package manager of your operating system or by running "composer require --dev dbrekelmans/bdi && vendor/bin/bdi detect drivers".');

可能的原因及解决步骤 #

1. 修复Chromedriver可执行权限 #

bdi安装后可能未给二进制文件添加执行权限，运行以下命令补全权限：

chmod +x ./drivers/chromedriver

2. 确认工作目录与路径匹配 #

Panther的ExecutableFinder会从当前执行脚本的目录查找./drivers路径。如果你的脚本在项目子目录（如src/）运行，会导致路径不匹配。

• 解决方案1：切换到项目根目录执行脚本/命令
• 解决方案2：手动指定Chromedriver路径：

use Symfony\Component\Panther\Client;

$client = Client::createChromeClient(null, null, [
    'chromedriver_binary' => __DIR__.'/../drivers/chromedriver', // 根据实际目录结构调整
]);

3. 校验Chromium与ChromeDriver版本兼容性 #

虽然bdi会自动匹配版本，但snap安装的Chromium可能存在版本差异。先检查两者版本：

# 查看Chromium版本
chromium --version
# 查看ChromeDriver版本
./drivers/chromedriver --version

确保主版本号一致（如均为123.x.x.x），若不匹配，重新执行bdi检测：

vendor/bin/bdi detect drivers

4. 检查ChromeDriver系统依赖 #

直接启动ChromeDriver，排查是否存在依赖缺失：

./drivers/chromedriver

若提示缺少系统库，安装对应依赖包：

sudo apt install libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcomposite1 libxcursor1 libxdamage1 libxi6 libxtst6 libcups2 libxss1 libxrandr2 libasound2 libpangocairo-1.0-0 libatk1.0-0 libgtk-3-0

5. 将ChromeDriver加入系统PATH #

若以上方法无效，可将ChromeDriver复制到系统全局可执行目录：

sudo cp ./drivers/chromedriver /usr/local/bin/
sudo chmod +x /usr/local/bin/chromedriver

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