Selenium Chrome WebDriver调用现有Chrome多配置文件失败问题排查

核心原因 #

1. 用户数据目录被锁定：当有Chrome实例（包括后台隐藏进程）正在占用默认用户数据目录时，WebDriver启动指定Profile的实例会因目录独占限制，无法正常初始化DevTools通信端口，进而抛出DevToolsActivePort文件不存在的错误。同时Chrome会强制复用现有实例的Profile配置，导致所有打开窗口的命令行都显示--profile-directory="Profile 1"。
2. Profile参数配置错误：未正确组合user-data-dir和profile-directory参数，或者路径格式（如空格、转义）有误，导致WebDriver无法定位到目标Profile文件夹。
3. 残留进程/资源冲突：之前的WebDriver或Chrome进程未完全终止，残留的临时文件（如scoped_dir）或端口占用，干扰了新实例的正常启动流程。

解决方法 #

• 彻底清理Chrome相关进程：打开任务管理器，结束所有chrome.exe和chromedriver.exe进程，确保用户数据目录没有被任何进程占用。
• 正确配置Profile参数：必须同时指定Chrome用户数据根目录和目标Profile文件夹，注意Windows路径的转义处理（使用原始字符串或双反斜杠）。示例代码（Python Selenium）：

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

opts = Options()
# 指向Chrome用户数据根目录
opts.add_argument(r"user-data-dir=C:\Users\myuser\AppData\Local\Google\Chrome\User Data")
# 指定目标Profile文件夹名
opts.add_argument(r"profile-directory=Profile 23")

driver = webdriver.Chrome(options=opts)
driver.get("https://your-target-url.com")

• 使用独立的Profile目录：如果需要同时运行多个Chrome实例，复制目标Profile到独立目录，避免与默认实例的目录冲突：
  1. 复制C:\Users\myuser\AppData\Local\Google\Chrome\User Data\Profile 23到C:\ChromeCustomProfiles\Profile23
  2. 代码中设置：opts.add_argument(r"user-data-dir=C:\ChromeCustomProfiles")和opts.add_argument(r"profile-directory=Profile23")
• 验证Profile文件夹的正确性：确认Profile 23文件夹确实存在于用户数据目录下，且名称与代码中完全匹配（注意空格和大小写）。
• 关闭Chrome后台运行：在Chrome设置的「系统」选项中，关闭「关闭Chrome后继续运行后台应用」，防止后台进程持续占用目录。

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