C# Selenium Edge：如何对接用户手动启动的Edge运行实例

核心实现逻辑 #

和Chrome场景的对接逻辑完全一致，本质都是通过Edge开放的远程调试端口，让WebDriver挂载到已运行的浏览器进程上，而非由WebDriver从零启动新的浏览器实例。之前对接失败的常见原因是用错了Edge对应的配置类、启动参数配置不符合要求。

落地实现步骤 #

1. 手动启动带远程调试能力的Edge实例 #

手动启动的时候不能直接双击桌面图标打开，必须通过命令行带指定参数启动，核心要配置两个参数：

• 开放指定的远程调试端口（比如9222）
• 指定独立的用户数据目录，避免和日常运行的Edge进程产生单实例锁冲突

对应启动命令示例：

# 替换Edge的实际安装路径、自定义用户数据目录路径
& "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" `
--remote-debugging-port=9222 `
--user-data-dir="C:\EdgeAutoTestUserData"

启动完成后，可以在浏览器地址栏访问http://localhost:9222/json/version，能返回结构化的浏览器版本信息，就说明调试端口正常开启。

2. C#端对接代码实现 #

首先确保项目安装了对应NuGet依赖：

• Selenium.WebDriver 核心自动化库
• Selenium.WebDriver.MSEdgeDriver 与本机Edge版本匹配的Edge驱动包

对接核心是在Edge选项中添加调试地址配置，由Edge驱动直接连接已运行的实例，不会新启动浏览器窗口：

using OpenQA.Selenium;
using OpenQA.Selenium.Edge;

// 初始化Edge专属配置项
var edgeOptions = new EdgeOptions();
// 填入刚才启动Edge时设置的远程调试地址
edgeOptions.AddDebuggerAddress("127.0.0.1:9222");

// 初始化驱动直接关联已运行的Edge实例
IWebDriver driver = new EdgeDriver(edgeOptions);

// 后续可直接操作当前已打开的浏览器页面，和常规Selenium操作逻辑一致
string currentPageUrl = driver.Url;
Console.WriteLine($"当前已打开页面地址：{currentPageUrl}");

常见对接失败排查项 #

• 端口不匹配：代码中填写的调试地址端口，和Edge启动时配置的--remote-debugging-port值不一致，导致连接被拒绝
• 版本错位：本机Edge的大版本、MSEdgeDriver的大版本、Selenium核心包的版本未完全对齐，会出现驱动握手失败的问题
• 进程冲突：如果Edge启动时没有指定独立的用户数据目录，且系统中已经有其他Edge进程在运行，那么新启动命令里的调试端口参数不会生效，Edge会直接唤起已有的旧进程，根本不会开放调试端口
• 配置类用错：把Chrome场景下的ChromeOptions对象传入Edge驱动的构造函数，没有用Edge专属的EdgeOptions添加调试地址参数

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