UI自动化查看器截图触发java.lang.reflect.InvocationTargetException错误

我之前也踩过这个一模一样的坑，折腾了好一阵才找到几个有效的解决方向，分享给你：

• 先排查版本兼容性问题
  这个异常大概率是UI Automation Viewer和Appium的版本不匹配导致的。比如Appium更新到了最新版，但Viewer还是旧的，或者反过来。建议：

  • 先卸载现有Appium，用命令 npm uninstall -g appium 清除，再安装最新稳定版 npm install -g appium
  • 确保UI Automation Viewer是对应Appium版本配套的（如果是Android SDK自带的uiautomatorviewer，也要同步更新Android SDK的platform-tools到稳定版）

• 检查被测应用的稳定性与权限
  你提到Appium服务器停止、应用关闭，说明截图操作直接把应用搞崩了。可以从这几点入手：

  • 确认被测应用开启了必要的权限，比如屏幕录制/截图权限、悬浮窗权限，这些权限缺失很可能导致UI层级获取失败
  • 手动启动应用后，让它在后台稳定运行几分钟，再用Viewer连接，排除应用本身内存泄漏、容易崩溃的问题
  • 如果是模拟器测试，试试换个模拟器镜像（比如从Android 13换成Android 11），有些高版本系统的权限限制更严格

• 深挖异常的真实原因
  java.lang.reflect.InvocationTargetException其实是个“包装异常”，真正的错误藏在它的底层栈里。你可以打开Appium的调试日志找线索：

  • 启动Appium时加上调试参数：appium --log-level debug
  • 触发异常后，在日志里搜索Caused by，后面跟着的就是真正导致崩溃的原因（比如某个UI控件无法解析、adb连接超时等）

• 换个工具试试
  如果UI Automation Viewer本身有bug，可以试试替代方案：

  • 用Appium Inspector代替它，功能更完善，兼容性也更好，能直接和Appium服务联动获取UI层级和截图
  • 手动用adb命令截图后分析：先执行 adb shell screencap -p /sdcard/screenshot.png 截图，再用 adb pull /sdcard/screenshot.png 把图片拉到本地，结合Appium返回的UI层级数据排查

• 清理系统环境干扰

  • 检查JDK版本，推荐用JDK 8或11，过高的JDK版本（比如17）可能和Appium的依赖不兼容
  • 关闭其他占用adb端口的工具（比如Android Studio的调试窗口、其他模拟器工具），避免端口冲突导致Appium服务崩溃

内容的提问来源于stack exchange，提问作者Anmol Singh