iOS Flutter应用对接Appium时Dart Observatory URI未找到的解决办法

以下是经过验证的解决步骤：

• 确保使用Debug/Profile模式构建应用
  Dart Observatory仅在非Release模式下可用，必须用Debug或Profile包进行自动化测试：

  • 构建Debug包：flutter build ios --debug
  • 构建Profile包：flutter build ios --profile
    同时在Xcode中确认Build Configuration设置为对应的Debug/Profile，不要使用Release模式。

• 配置正确的Appium Capabilities
  启动Appium会话时，必须包含Flutter相关配置项：

  {
    "platformName": "iOS",
    "deviceName": "你的设备名称",
    "app": "/path/to/your/flutter-app-debug.ipa",
    "flutterEnabled": true,
    "autoAcceptAlerts": true,
    "udid": "设备UDID"
  }
  

  重点确保flutterEnabled设为true，且app指向正确的Debug/Profile包路径。

• 检查设备日志访问权限
  macOS系统需要授予Appium或终端访问设备日志的权限：

  1. 打开「系统偏好设置」→「安全性与隐私」→「隐私」→「完全磁盘访问」
  2. 将终端（或运行Appium的进程）添加到权限列表
  3. 重启终端/Appium后，执行idevicesyslog -u <设备UDID>测试能否正常获取设备日志，确认日志中存在Dart Observatory相关输出。

• 手动指定Dart Observatory URI
  如果自动检测失败，可手动获取URI并配置：

  1. 通过Xcode启动应用，在Debug控制台查找类似Observatory listening on http://127.0.0.1:xxxx/xxxxxx/的日志行
  2. 或在终端执行flutter attach命令，连接运行中的应用获取URI
  3. 在Appium Capabilities中添加dartObservatoryUri项：

  {
    // 其他capabilities...
    "dartObservatoryUri": "http://127.0.0.1:xxxx/xxxxxx/"
  }
  

• 升级相关工具版本
  旧版本可能存在兼容性问题，建议升级到最新稳定版：

  • 升级Flutter SDK：flutter upgrade
  • 升级Appium Flutter Driver：npm install appium-flutter-driver@latest
  • 升级Appium本身到最新稳定版

• 验证Observatory服务可用性
  获取URI后，用浏览器访问该地址，确认能正常打开Dart Observatory页面。如果无法访问，说明应用的Observatory服务未正常启动，检查Flutter项目是否有禁用Observatory的编译配置。

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