如何排查 WebDriver 连接问题
尝试使用 Selenium 自动化 Multilogin 浏览器配置文件,但脚本无法连接?请先检查配置文件是否已成功启动,以及脚本是否使用了正确的连接端口。
➡️ 在脚本中找到“Start Browser Profile”请求→检查 automation_type=selenium →从响应获取 data.port →使用 webdriver.Remote 连接。
Multilogin 使用 Remote WebDriver 将 Selenium 连接到运行中的 Mimic 浏览器配置文件。如果改用 webdriver.Chrome(),Selenium 会启动单独的浏览器,而不是连接你的 Multilogin 配置文件。
检查浏览器配置文件是否启动
在排查 Selenium 问题前,请确保 Multilogin 可以启动浏览器配置文件。如果配置文件未启动,脚本就没有可连接的对象。
检查以下信息:
- Multilogin 正在运行:确保桌面应用已打开
- 配置文件 ID 正确:检查是否使用了正确的文件夹 ID 和配置文件 ID
- API 令牌有效:确保请求包含可用的令牌
- 端点正确:使用“Start Browser Profile”请求
- 已启用自动化:设置
automation_type=selenium
以下是启动请求的示例:
GET https://launcher.mlx.yt:45001/api/v2/profile/f/{folder_id}/p/{profile_id}/start?automation_type=selenium&headless_mode=false将 {folder_id} 和 {profile_id} 替换为实际 ID。
请求成功时,Multilogin 会启动 Mimic 浏览器配置文件,并返回包括 data.port 在内的连接详情。
将 Selenium 连接到 Mimic 浏览器配置文件
配置文件启动后,Selenium 需要连接到同一浏览器会话。
使用 webdriver.Remote 和 Multilogin 返回的端口。由于 Mimic 基于 Chromium,你还需要 ChromiumOptions()。
以下是 Python 连接示例:
from selenium import webdriverfrom selenium.webdriver.chromium.options import ChromiumOptionsdriver = webdriver.Remote( command_executor=f"http://127.0.0.1:{port}", options=ChromiumOptions())这里的 port 是启动配置文件时 data.port 返回的值。
请记住以下几点:
- 使用最新端口:重启配置文件后端口可能变化,因此不要在脚本中写死端口
- 等待配置文件启动:仅在 API 确认启动请求成功后才连接
- 保持配置文件运行:Selenium 需要连接到活动的浏览器会话
使用 Remote WebDriver 无需另一台计算机。连接在本地通过 127.0.0.1 进行。
你也无需启动单独的 ChromeDriver,或手动使其版本与 Mimic 匹配。Multilogin 会启动浏览器会话,并向 Selenium 提供连接端口。
检查防火墙和杀毒软件设置
如果浏览器配置文件已启动,但 Selenium 仍无法连接,防火墙或杀毒软件可能阻止了本地连接。
可以尝试以下操作:
- 检查防火墙或杀毒软件是否阻止了本地连接
- 确保允许脚本和 Multilogin 之间通过
127.0.0.1及返回的端口进行连接 - 再次运行脚本,查看连接是否正常
无需关闭安全软件。检查其设置,并在必要时添加例外。
检查其他可能的连接问题
仍然报错?以下情况也可能阻止脚本连接:
- API 错误:查看响应状态和正文,了解出错详情
- 身份验证:确保 API 令牌未过期
- 配置文件访问权限:检查你的工作区角色是否允许启动该配置文件
- Multilogin 日志:查看是否有错误可以解释浏览器无法启动或连接的原因
如果不确定脚本设置是否正确,请与 Selenium 自动化示例对照。
你也可以查看 Multilogin API 文档,了解必需的请求参数和响应详情。