解决uiautomatorviewer报错：Unexpected error while obtaining UI hierarchy的实战指南
1. 遇到uiautomatorviewer报错怎么办？
最近在调试Android应用UI时，你是不是也遇到了这个烦人的错误提示："Unexpected error while obtaining UI hierarchy"？别担心，这几乎是每个Android开发者都会踩的坑。我刚开始用uiautomatorviewer时，看到这个报错也是一头雾水，后来才发现这是Android 8.0以上版本的兼容性问题。
这个工具原本是Android SDK自带的UI分析神器，可以像X光机一样透视应用的界面结构。但官方很久没更新了，导致在高版本系统上直接罢工。报错信息里那个"java.lang.reflect.InvocationTarget"看着吓人，其实解决方法比想象中简单——换个"心脏"就行。
2. 为什么会出现这个错误？
2.1 底层原理分析
uiautomatorviewer的工作原理是通过ADB与设备通信，获取当前屏幕的UI层级信息。但在Android 8.0之后，系统内部的数据结构发生了变化，就像换了新锁但工具还是拿着旧钥匙。特别是涉及到反射调用时，老版本的jar包根本无法正确解析新系统的响应数据。
我在实际测试中发现，这个问题在Android 9.0上尤其明显。当你点击那个熟悉的设备截图按钮时，工具会先卡住几秒，然后弹出一堆看不懂的堆栈信息。根本原因是工具内置的uiautomator库版本太旧，无法理解新系统"说话的方式"。
2.2 常见错误场景
- 连接Android 8.0+设备时必现
- 点击"Device Screenshot"按钮后卡死
- 控制台输出包含"InvocationTargetException"
- 偶尔会伴随"Failed to get hierarchy"提示
3. 完美解决方案：替换关键jar文件
3.1 准备工作
首先需要准备三个关键文件：
- 新版uiautomatorviewer.jar（核心功能）
- LvmamaXmlKit.jar（XML解析器）
- uiautomatorviewer.jar2（备选版本）
这些文件可以在开源社区找到，比如gitee上就有开发者维护的兼容版本。我建议两个版本的uiautomatorviewer.jar都下载，因为有些特殊场景下可能需要切换使用。
3.2 详细操作步骤
步骤1：备份原文件
进入你的SDK目录，找到tools/lib下的原始jar文件：
cd D:\android-sdk-windows\tools\lib mv uiautomatorviewer.jar uiautomatorviewer.bak步骤2：放入新文件
把下载的新版jar文件复制到这个目录。这里有个小技巧：如果你下载的是uiautomatorviewer.jar2，需要先重命名：
cp ~/Downloads/uiautomatorviewer.jar2 ./uiautomatorviewer.jar步骤3：部署手机端组件
LvmamaXmlKit.jar需要推送到设备上：
adb push LvmamaXmlKit.jar /data/local/tmp/这个文件相当于翻译官，帮助新旧系统之间正确传递数据。
3.3 验证是否生效
现在重新启动uiautomatorviewer，应该能看到熟悉的界面又回来了。点击截图按钮时，注意观察控制台输出，不再出现反射错误就说明成功了。
我在小米、华为等多款Android 10+设备上测试过这个方法，成功率接近100%。如果还是不行，可以尝试另一个版本的jar文件，有时候不同厂商的系统会有微小差异。
4. 常见问题排查
4.1 文件权限问题
遇到过几次adb push失败的情况，通常是临时目录权限不足。可以尝试：
adb shell chmod 777 /data/local/tmp然后再重新推送jar文件。
4.2 版本冲突
有些环境下会出现类加载冲突，这时需要彻底清理旧文件：
rm D:\android-sdk-windows\tools\lib\uiautomator*.jar然后重新放入新文件，确保没有残留。
4.3 备选方案
如果上述方法都不奏效，可以考虑使用Android Studio自带的Layout Inspector。虽然功能略有不同，但在高版本系统上更稳定。不过对于自动化测试场景，还是uiautomatorviewer更方便。
5. 为什么这个方法有效？
关键点在于替换的jar文件包含了新版uiautomator的实现。社区开发者们反向工程了高版本Android系统的通信协议，重新实现了数据解析逻辑。LvmamaXmlKit.jar则专门处理了XML格式的适配问题，相当于在工具和系统之间架了一座桥。
实际使用中我发现，修改后的工具不仅能正常工作，有时加载速度反而比原来更快。这是因为新版优化了数据压缩传输的算法，减少了不必要的网络往返。