Azure Pipelines中Appium测试Assembly初始化抛出异常问题

核心排查与修复方案 #

1. 确保Appium服务完全启动后再执行测试 #

你用nohup appium -p 4723 &后台启动服务，但流水线中命令执行后立刻跑dotnet test，大概率是Appium还没完成初始化就被请求，导致报错。

解决方法：

• 添加延迟等待，根据Agent性能调整时长：

  nohup appium -p 4723 &
  sleep 30  # 等待30秒确保服务就绪
  dotnet test <csproj name> --logger trx --results-directory $(Agent.TempDirectory) --verbosity:detailed
  

• 或者用端口检查替代固定延迟，更可靠：

  nohup appium -p 4723 &
  # 循环检查4723端口，最多等待60秒
  timeout 60 bash -c 'until nc -z localhost 4723; do sleep 5; done'
  dotnet test <csproj name> --logger trx --results-directory $(Agent.TempDirectory) --verbosity:detailed
  

2. 补全流水线Agent的Appium依赖 #

本地Mac环境配置完整，但流水线Agent可能缺少Android SDK、UiAutomator2驱动或Java运行时等核心依赖。

解决方法：

• 在流水线步骤中添加依赖安装命令：
  • 安装UiAutomator2驱动：appium driver install uiautomator2
  • 确认ANDROID_HOME环境变量已正确设置
  • 检查Agent的JDK版本是否符合Appium要求（建议JDK 11+）

3. 捕获Appium启动日志排查问题 #

nohup默认输出到nohup.out，流水线中无法直接查看，可能Appium启动失败但未被发现。

解决方法：

• 重定向日志到Agent临时目录，后续可作为附件上传分析：

  nohup appium -p 4723 > $(Agent.TempDirectory)/appium.log 2>&1 &
  sleep 30
  dotnet test <csproj name> --logger trx --results-directory $(Agent.TempDirectory) --verbosity:detailed
  

• 在流水线中添加"发布构建工件"步骤，将appium.log上传，便于排查启动失败原因

4. 显式指定AndroidDriver的Appium端点 #

即使Desired Capabilities正确，也可能存在端点地址不匹配的问题（比如Appium绑定127.0.0.1但测试代码用了其他地址）。

解决方法：

• 初始化AndroidDriver时显式指定服务地址：

  var driverUri = new Uri("http://127.0.0.1:4723/wd/hub");
  var driver = new AndroidDriver<AndroidElement>(driverUri, desiredCapabilities);
  

• 启动Appium时显式绑定地址，避免歧义：

  nohup appium -p 4723 --address 127.0.0.1 > $(Agent.TempDirectory)/appium.log 2>&1 &
  

5. 检查Agent运行权限 #

Agent可能没有足够权限访问Android设备/模拟器、SDK目录或启动Appium服务。

解决方法：

• 确保Agent用户对Android SDK目录有读写权限
• 若使用真机，确认USB调试权限已开启；若使用模拟器，确保流水线中已提前启动模拟器且状态正常

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