BrowserStack NUnit测试项目无法本地运行的问题求助

核心原因 #

从你提供的adapter.log日志能明确：通过BrowserStack快速启动页面创建的项目，默认集成了BrowserStack SDK和Visual Studio测试适配器，它们会自动拦截测试执行流程，强制将Selenium的WebDriver请求路由到BrowserStack云端，直接覆盖你原本的本地驱动初始化逻辑。

日志中关键触发点：

Invoking browserstack-sdk with args: --skip-build-browserstack "C:\vs_code\NUnit-BrowserStack\NUnit-BrowserStack\bin\Debug\net8.0\SingleTest.dll"

SDK会完全接管测试的启动流程，导致你的本地代码无法正常调用本地浏览器。

控制测试运行位置的关键因素 #

1. BrowserStack SDK与测试适配器：这是强制云端执行的核心，SDK会自动注入代理逻辑，修改WebDriver的创建方式。
2. 自动生成的配置文件：项目中的browserstack.yml、临时目录的.runsettings文件包含云端执行的默认配置，会被SDK读取并应用。
3. WebDriver初始化逻辑：若代码中使用了BrowserStack提供的专属驱动初始化方法，会固定指向云端，而非标准Selenium本地驱动。

解决步骤 #

1. 移除BrowserStack SDK与测试适配器依赖 #

• 在Visual Studio的NuGet包管理器中，卸载BrowserStack.TestAdapter包
• 移除全局安装的BrowserStack SDK，执行命令：

  dotnet tool uninstall -g browserstack-sdk
  

2. 清理自动生成的配置文件 #

• 删除项目根目录下的browserstack.yml文件
• 删除临时目录中的.runsettings（日志路径：C:\Users\j_f\AppData\Local\Temp\.browserstack\.runsettings），同时检查项目内是否存在本地.runsettings文件并移除相关BrowserStack配置

3. 恢复本地WebDriver初始化逻辑 #

确保测试代码使用标准Selenium本地驱动初始化，示例：

using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;

[TestFixture]
public class LocalChromeTest
{
    private IWebDriver _driver;

    [SetUp]
    public void Setup()
    {
        // 本地Chrome驱动初始化，需确保chromedriver.exe版本与本地Chrome匹配
        _driver = new ChromeDriver();
    }

    [Test]
    public void LocalSiteTest()
    {
        _driver.Navigate().GoToUrl("https://your-target-site.com");
        // 自定义测试逻辑
    }

    [TearDown]
    public void TearDown()
    {
        _driver.Quit();
    }
}

4. 可选：实现本地/云端一键切换 #

若需要保留云端执行能力，可通过环境变量切换驱动逻辑：

[SetUp]
public void Setup()
{
    string testEnv = Environment.GetEnvironmentVariable("TEST_ENV") ?? "local";

    if (testEnv.Equals("browserstack", StringComparison.OrdinalIgnoreCase))
    {
        // 云端驱动初始化
        var capabilities = new Dictionary<string, object>
        {
            { "browserName", "chrome" },
            { "bstack:options", new Dictionary<string, object>
                {
                    { "os", "Windows" },
                    { "osVersion", "11" },
                    { "userName", "你的BrowserStack用户名" },
                    { "accessKey", "你的BrowserStack密钥" }
                }
            }
        };
        _driver = new RemoteWebDriver(
            new Uri("https://hub.browserstack.com/wd/hub"),
            new ChromeOptions().AddAdditionalCapability("bstack:options", capabilities["bstack:options"], true)
        );
    }
    else
    {
        // 本地驱动初始化
        _driver = new ChromeDriver();
    }
}

运行前设置环境变量TEST_ENV=browserstack即可切换到云端执行，默认本地运行。

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