Linux环境下Selenium调用Firefox驱动失败的问题求助

问题背景 #

我在Linux环境下使用Selenium 4.18.1调用Firefox驱动时遇到了两个棘手的问题，折腾了半天没搞定，特来求助：

我的环境信息如下：

• geckodriver状态：-rwxr-xr-x 1 kyle kyle 6132584 Feb 24 09:27 /usr/local/bin/geckodriver
• 系统PATH：/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/home/kyle/.dotnet/tools（geckodriver所在的/usr/local/bin已在PATH中）
• Selenium版本：4.18.1

问题1：自动查找驱动失败

直接执行以下代码时：

driver = webdriver.Firefox()

报错信息：

Message: Unable to obtain driver for firefox using Selenium Manager.

问题2：手动传入驱动路径报错

尝试手动指定驱动路径时：

driver = webdriver.Firefox("/usr/local/bin/geckodriver")

触发AttributeError：

Traceback (most recent call last):
File "/usr/lib/python3/dist-packages/selenium/webdriver/common/driver_finder.py", line 38, in get_path
path = SeleniumManager().driver_location(options) if path is None else path
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3/dist-packages/selenium/webdriver/common/selenium_manager.py", line 87, in driver_location
browser = options.capabilities["browserName"]
^^^^^^^^^^^^^^^^^^^^
AttributeError: 'str' object has no attribute 'capabilities'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "/home/kyle/Documents/ElecticityUsage.py", line 181, in <module>
driver = webdriver.Firefox("/usr/local/bin/geckodriver")
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3/dist-packages/selenium/webdriver/firefox/webdriver.py", line 59, in __init__
self.service.path = DriverFinder.get_path(self.service, options)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3/dist-packages/selenium/webdriver/common/driver_finder.py", line 40, in get_path
msg = f"Unable to obtain driver for {options.capabilities['browserName']} using Selenium Manager."
^^^^^^^^^^^^^^^^^^^^
AttributeError: 'str' object has no attribute 'capabilities'

问题分析与解决办法 #

嗨，我来帮你拆解下这两个问题的根源和解决思路：

先搞定第二个问题：传参方式错误

这个问题是Selenium 4+版本的API变更导致的——从Selenium 4开始，webdriver.Firefox()的第一个参数不再接受驱动路径字符串，驱动路径需要通过Service对象来传递。

正确的写法应该是这样：

from selenium import webdriver
from selenium.webdriver.firefox.service import Service

# 1. 实例化Service对象，传入geckodriver的绝对路径
gecko_service = Service(executable_path="/usr/local/bin/geckodriver")
# 2. 将Service对象传给Firefox的service参数
driver = webdriver.Firefox(service=gecko_service)

这样就能正确指定驱动路径，不会再触发AttributeError了。

再解决第一个问题：Selenium Manager自动识别失败

你的geckodriver已经在PATH里，但Selenium Manager没检测到，可能有这几个原因：

1. 版本不兼容：检查Firefox浏览器版本和geckodriver版本是否匹配（比如Firefox 120+需要geckodriver 0.34+），版本不匹配会导致Selenium Manager识别失败。
2. Selenium Manager配置限制：可以通过环境变量强制它优先使用本地已有的驱动，跳过自动下载：

import os
# 让Selenium Manager跳过浏览器/驱动下载，优先使用本地文件
os.environ["SE_MANAGER_SKIP_BROWSER_DOWNLOAD"] = "1"

from selenium import webdriver
driver = webdriver.Firefox()

3. 更新Selenium版本：你的Selenium 4.18.1可能存在小bug，尝试更新到最新版：

pip install --upgrade selenium

4. 查看调试日志：如果还是没解决，可以开启Selenium Manager的调试日志，看看它的检测过程到底卡在哪里：

import os
os.environ["SE_MANAGER_LOG_LEVEL"] = "DEBUG"

from selenium import webdriver
driver = webdriver.Firefox()

日志会输出详细的查找过程，能帮你精准定位问题。

内容来源于stack exchange