如何在Python版Selenium中恢复WebDriver默认配置并解决驱动路径报错

核心排查与修复步骤 #

设置Edge无头参数本身不会影响其他浏览器，问题大概率出在系统PATH配置、驱动版本不匹配，或是Selenium全局配置被误修改。以下是分步解决方案：

1. 检查系统PATH环境变量 #

• Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，确认驱动所在文件夹路径已添加到系统PATH（仅放工作目录无法全局生效）
• macOS/Linux：终端输入echo $PATH，检查驱动目录是否在输出列表中
• 添加路径后重启终端或IDE，确保配置生效

2. 严格匹配驱动与浏览器版本 #

每个浏览器的驱动必须和浏览器主版本完全对应，版本不匹配是这类报错的核心原因：

• Edge：打开Edge→「设置」→「关于Microsoft Edge」查看版本，下载对应位数的msedgedriver.exe
• Chrome：打开Chrome→「设置」→「关于Chrome」查看版本，下载对应chromedriver.exe
• Firefox：打开Firefox→「帮助」→「关于Firefox」查看版本，下载对应geckodriver.exe

3. 重置Selenium全局配置 #

检查代码中是否存在全局指定Edge驱动的逻辑，导致其他浏览器调用时路径混淆：

# 错误示例：全局绑定Edge驱动，干扰其他浏览器
from selenium import webdriver
webdriver.Edge(executable_path="path/to/msedgedriver.exe")

# 正确做法：每个浏览器单独配置驱动，或使用自动管理
from selenium import webdriver
from selenium.webdriver.edge.options import Options

# Edge新版无头模式配置（Selenium 4+）
edge_options = Options()
edge_options.add_argument("--headless=new")  # 替代旧版--headless参数，兼容性更好
edge_options.add_argument("--disable-gpu")
driver = webdriver.Edge(options=edge_options)

Selenium 4.6+支持自动下载匹配驱动，无需手动配置PATH，优先推荐使用该版本。

4. 手动指定驱动绝对路径 #

若自动管理失效，可为每个浏览器明确指定驱动绝对路径，避免路径冲突：

# Chrome手动指定驱动示例
from selenium.webdriver.chrome.service import Service
from selenium import webdriver

chrome_service = Service(executable_path="C:/full/path/to/chromedriver.exe")
driver = webdriver.Chrome(service=chrome_service)

5. 清理旧驱动残留 #

• 删除工作目录、系统临时文件夹中的旧驱动文件
• 重启浏览器和IDE，避免进程残留导致的路径异常

注意：旧版Edge的--headless参数存在兼容性问题，Selenium 4+建议使用--headless=new参数提升稳定性。

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