不同版本的 Selenium 和 WebDriver 的 API 兼容性问题

news2024/10/8 13:50:37

TypeError: __init__() got an unexpected keyword argument 'executable_path' 是一个常见的错误，通常出现在使用 Selenium 自动化测试工具时。此错误通常是由于不同版本的 Selenium 和 WebDriver 的 API 变化引起的。以下是此问题的详细分析及解决方法。

问题分析

Selenium 是一个用于浏览器自动化的工具，它通过 WebDriver 来控制浏览器。随着 Selenium 的更新，某些参数的使用方式会发生变化。例如，在 Selenium 3 及更早版本中，webdriver.Chrome() 的 __init__ 方法可以接受 executable_path 参数，用于指定 ChromeDriver 的路径。然而，在 Selenium 4 中，webdriver.Chrome() 的初始化方法不再接受 executable_path 参数，而是使用 webdriver.Chrome(service=Service('path_to_driver')) 的方式来指定驱动路径。

因此，当你在 Selenium 4 中仍然使用 executable_path 参数时，就会触发 TypeError: __init__() got an unexpected keyword argument 'executable_path' 错误。

解决方案

要解决这个问题，需要根据所使用的 Selenium 版本来调整代码。以下提供几种不同情况下的解决方案。

方案 1：针对 Selenium 4 的解决方案

Selenium 4 引入了 Service 类来管理浏览器驱动，因此你需要使用 Service 类来传递驱动路径：

from selenium import webdriver
from selenium.webdriver.chrome.service import Service

# 使用 Service 类指定驱动路径
service = Service(executable_path='path_to_chromedriver')
driver = webdriver.Chrome(service=service)

在上述代码中，我们通过 Service 实例化了一个对象 service，然后将其作为参数传递给 webdriver.Chrome() 的 service 参数。这样就可以避免 executable_path 的错误。

方案 2：将 Selenium 降级到 3.x 版本

如果你不想修改现有代码，可以将 Selenium 降级到 3.x 版本，这样可以继续使用 executable_path 参数：

卸载当前的 Selenium：
```
pip uninstall selenium
```
安装 Selenium 3.x 版本：
```
pip install selenium==3.141.0
```

安装完成后，你可以继续使用如下代码：

from selenium import webdriver

# 继续使用 executable_path 参数
driver = webdriver.Chrome(executable_path='path_to_chromedriver')

此时不会再出现 TypeError 错误。

方案 3：使用 `Options` 类和 `Service` 类

如果你在使用 Options 类来配置浏览器启动选项时，可以结合 Options 和 Service 类一起使用：

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options

# 创建 ChromeOptions 实例
options = Options()
options.add_argument('--headless')  # 无头模式启动

# 创建 Service 实例并指定 ChromeDriver 路径
service = Service(executable_path='path_to_chromedriver')

# 将 service 和 options 传递给 Chrome
driver = webdriver.Chrome(service=service, options=options)

在这个方案中，我们不仅传递了驱动路径，还传递了浏览器启动选项，适合复杂的自动化测试场景。