Appium启动新会话时报错，如何排查instrumentation初始化问题？

这个报错我之前排查过好几次，核心就是Appium没法通过instrumentation机制和被测应用建立连接，直接导致界面加载、元素定位全失效。下面是我亲测有效的排查和解决步骤：

• 先确认被测应用本身是否正常

  • 手动启动设备上的被测App，看能不能正常打开、进入主界面，有没有闪退、崩溃的情况。如果手动启动都失败，优先修复应用本身问题（比如安装包损坏、签名不一致）。
  • 检查应用的AndroidManifest.xml里是否声明了android:debuggable="true"——instrumentation必须依赖可调试状态的应用才能工作。

• 深挖Logcat日志找根因

  • 用Android Studio的Logcat工具，或者直接跑命令adb logcat，过滤关键词instrumentation、AndroidRuntime、FATAL EXCEPTION，定位报错前后的关键日志。常见触发点有：
    • 应用启动时抛出未捕获异常，导致进程直接崩溃
    • 权限不足：应用需要的核心权限没授予，或是Appium测试进程没有访问应用的权限
    • 版本不兼容：Appium版本和被测应用的Android SDK版本不匹配

• 检查Appium会话的配置参数

  • 确认desiredCapabilities里的appPackage和appActivity完全正确——可以用命令adb shell dumpsys window | grep mCurrentFocus获取当前打开应用的包名和Activity做对比。
  • 调试阶段可以调整noReset/fullReset参数：fullReset会卸载重装应用，能解决缓存残留问题；noReset保留应用数据，但如果之前会话有残留可能触发异常。
  • 确保automationName设置为UiAutomator2（Android平台官方推荐的自动化引擎，instrumentation是它的底层依赖）。

• 清理环境缓存，重启相关服务

  • 重启被测设备（真机/模拟器），设备资源占用过高时，instrumentation进程经常启动失败。
  • 停止Appium服务，杀掉设备上的io.appium.uiautomator2.server和io.appium.uiautomator2.server.test进程（用adb shell ps | grep uiautomator找到进程ID，再用adb kill <pid>杀掉），之后重新启动会话。
  • 用appium driver install uiautomator2命令更新Appium的uiautomator2驱动，避免驱动版本过时导致的兼容问题。

• 排查厂商系统的权限限制

  • 给被测应用授予所有必要权限，尤其是悬浮窗、后台启动这类特殊权限。
  • 真机要确认开发者选项、USB调试模式已开启，并且已经信任连接的电脑。
  • 小米MIUI、华为EMUI这类定制系统，往往会限制调试进程权限，需要开启“USB调试（安全设置）”，关闭相关的安全拦截功能。

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