Python Selenium无头模式启动失败及参数错误问题求助

1. 解决TypeError: WebDriver.__init__() got an unexpected keyword argument 'executable_path' #

这个错误是因为Selenium 4.x版本起，不再支持直接通过executable_path参数传递驱动路径，需改用Service类管理驱动。修改Python脚本中的WebDriver初始化代码：

报错的旧代码： #

from undetected_chromedriver import Chrome

driver = Chrome(executable_path="/path/to/chromedriver")

修复后的新代码： #

from undetected_chromedriver import Chrome, ChromeOptions
from selenium.webdriver.chrome.service import Service

# 指定驱动路径
service = Service(executable_path="/path/to/chromedriver")
# 初始化浏览器
driver = Chrome(service=service)

如果你的undetected_chromedriver版本足够新，甚至无需手动指定驱动路径，它会自动匹配对应版本的Chrome驱动：

from undetected_chromedriver import Chrome

driver = Chrome()

2. 解决无头模式（RUN_HEADLESS=True）下Chrome无法连接的WebDriverException #

无头模式下需补充Chrome配置参数，避免沙箱、权限或窗口环境问题导致连接失败。修改Python脚本中的ChromeOptions配置：

from undetected_chromedriver import Chrome, ChromeOptions
from selenium.webdriver.chrome.service import Service

RUN_HEADLESS = True

options = ChromeOptions()
if RUN_HEADLESS:
    options.add_argument("--headless=new")  # 新版无头模式，兼容性优于旧版
    options.add_argument("--no-sandbox")  # 禁用沙箱，解决权限限制问题
    options.add_argument("--disable-dev-shm-usage")  # 缓解/dev/shm内存不足问题
    options.add_argument("--window-size=1920,1080")  # 指定窗口尺寸，避免布局异常
    options.add_argument("--disable-gpu")  # 禁用GPU加速，适配部分环境

service = Service(executable_path="/path/to/chromedriver")
driver = Chrome(service=service, options=options)

关键说明：

• --headless=new替代旧的--headless，新版无头模式更接近正常浏览器环境
• --no-sandbox和--disable-dev-shm-usage是解决Linux或容器环境下常见的启动失败问题
• 指定窗口大小可避免部分网站因无头模式无默认窗口尺寸而拒绝服务

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