Appium Inspector无法运行报错：需包含platformName capability

1. 检查Capability的拼写与格式 #

• 确保platformName拼写完全正确，注意大小写规则（首字母大写，其余小写，不能写成PlatformName或platformname）
• 确认Capability以正确的键值对形式配置，示例JSON格式如下：

  {
    "platformName": "Android", // 对应iOS平台则填"iOS"
    "deviceName": "你的设备名称",
    // 其他必填Capability（如appPackage/appActivity或bundleId等）
  }
  

2. 验证Capability是否被正确传入 #

• 在Appium Inspector的Capabilities标签页，确认列表中确实存在platformName项，且已设置对应平台的值（Android/iOS）
• 添加完成后点击右上角的Save按钮保存配置，避免因输入框焦点问题导致内容未被记录

3. 检查Appium版本兼容性 #

• 若使用Appium 2.x版本，确认Inspector版本与服务端版本匹配，版本不兼容可能引发Capability识别异常
• 可通过终端启动Appium服务时添加日志参数appium --log-level debug，启动会话后查看日志，确认platformName是否被服务端正确接收

4. 排查自定义配置或环境干扰 #

• 检查是否存在自定义Appium配置文件（如appium.config.js），确认其中没有覆盖platformName的设置，导致该Capability被清空或未传递
• 暂时关闭代理工具或异常环境变量，避免配置被拦截或篡改

5. 重置Inspector配置 #

• 打开Appium Inspector的设置页面，选择Reset to Defaults选项重置所有配置，之后重新手动添加platformName及其他必填Capability，再尝试创建会话

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