Selenium连接已启动的无头Chrome实例失败如何解决？

要解决无法连接无头Chrome实例的问题，核心是确保Chrome启动参数正确，同时Selenium的配置匹配，以下是具体方案：

1. 正确启动无头Chrome实例 #

使用Chrome 112+推荐的新无头模式（--headless=new）搭配完整远程调试参数，旧的--headless参数在调试连接上存在兼容性问题，这大概率是你失败的原因。启动命令如下：

chrome --headless=new --remote-debugging-port=8989 --remote-allow-origins=* --remote-debugging-address=0.0.0.0

注意：如果你的Chrome版本低于112，改用--headless=chrome替代--headless=new，避免旧无头模式的限制。

2. Selenium连接代码（Python示例） #

配置ChromeOptions指定调试地址，确保代码与启动的Chrome实例端口一致：

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

options = Options()
# 对应启动时的远程调试端口
options.add_experimental_option("debuggerAddress", "localhost:8989")
driver = webdriver.Chrome(options=options)

# 验证连接成功
print(driver.title)
# 操作完成后关闭
driver.quit()

3. 常见问题排查 #

• 版本兼容性：确保Selenium版本（推荐4.x+）与Chrome版本匹配，旧版Selenium不支持新无头模式的调试协议。
• 端口占用检查：用lsof -i :8989（Linux/macOS）或netstat -ano | findstr :8989（Windows）确认8989端口被Chrome进程占用，无冲突。
• 清理残留进程：彻底关闭所有Chrome进程后再重新启动带参数的无头实例，残留进程可能导致端口异常。
• 防火墙/代理拦截：暂时关闭本地防火墙或代理，排查是否有网络拦截导致无法连接。

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