Playwright+BStack移动端测试启动设备后报AndroidDevice缺失错误

技术栈环境 #

• Playwright.Microsoft
• SpecFlow
• NUnit Framework
• BrowserStack 移动端自动化测试

Feature 测试用例定义 #

Scenario: Mobile test for browserstack  
Given I setup my browserstack connection  
When I navigate to Rail Informatieportaal Test

问题现象 #

执行步骤定义代码后出现以下异常：

• BrowserStack控制台显示目标移动设备已成功启动
• 设备端浏览器未正常打开
• Visual Studio测试资源管理器抛出错误：

Microsoft.Playwright.PlaywrightException : System.Collections.Generic.KeyNotFoundException: The given key 'AndroidDevice' was not present in the dictionary.

注：基于相同技术栈的BrowserStack桌面端自动化测试可正常运行

问题原因 #

报错直接指向代码中尝试访问名为AndroidDevice的字典键但该键不存在，核心原因是移动端BrowserStack的会话初始化逻辑复用了桌面端代码，未适配移动端的Capabilities配置规则，导致Playwright无法正确识别移动端设备参数，进而无法启动浏览器会话。

解决方案 #

1. 修正移动端BrowserStack Capabilities配置 #

移动端与桌面端的BrowserStack Capabilities配置差异极大，需重新编写初始化逻辑，示例C#步骤定义代码如下：

using TechTalk.SpecFlow;
using Microsoft.Playwright;
using System.Collections.Generic;
using System.Threading.Tasks;

[Binding]
public class BrowserStackMobileSteps
{
    private IPage _testPage;
    private IBrowser _browserInstance;

    [Given(@"I setup my browserstack connection")]
    public async Task SetupBrowserStackMobileConnection()
    {
        var playwright = await Playwright.CreateAsync();
        
        var launchOptions = new BrowserTypeLaunchOptions
        {
            // 安卓指定chrome渠道，iOS指定safari
            Channel = "chrome",
            // 配置BrowserStack远程节点及认证信息
            Proxy = new ProxySettings
            {
                Server = "http://hub.browserstack.com/wd/hub",
                Username = "你的BrowserStack用户名",
                Password = "你的BrowserStack访问密钥"
            },
            // 注入BrowserStack移动端专属配置
            ExtraHttpHeaders = new Dictionary<string, string>
            {
                ["bstack:options"] = @"
                {
                    ""deviceName"": ""Google Pixel 7"",
                    ""osVersion"": ""13.0"",
                    ""projectName"": ""Rail Informatieportaal Test"",
                    ""buildName"": ""Mobile Automation Build 1"",
                    ""debug"": ""true""
                }"
            }
        };

        // 用Chromium启动会话（安卓Chrome/iOS Safari均基于此）
        _browserInstance = await playwright.Chromium.LaunchAsync(launchOptions);
        _testPage = await _browserInstance.NewPageAsync();
    }

    [When(@"I navigate to Rail Informatieportaal Test")]
    public async Task NavigateToTestPortal()
    {
        await _testPage.GotoAsync("你的测试门户URL");
    }

    [AfterScenario]
    public async Task CleanupBrowserSession()
    {
        await _browserInstance?.CloseAsync();
    }
}

2. 移除/修正AndroidDevice字典引用 #

搜索所有步骤定义、工具类代码，找到类似var deviceConfig = configDictionary["AndroidDevice"]的代码段：

• 如果是自定义设备字典，确认已添加AndroidDevice键及对应配置
• 如果是误用桌面端设备选择逻辑，直接替换为上述移动端Capabilities配置方式

3. 验证BrowserStack配置有效性 #

• 确认用户名、访问密钥正确无误
• 检查deviceName和osVersion在BrowserStack官方设备列表中可用
• 开启debug: true参数，查看BrowserStack控制台的会话日志，定位潜在配置问题

内容的提问来源于stack exchange，提问作者Lucas Noordzij
</answer_never_used_51bce0c785ca2f68081bfa7d91973934>