HarmonyOS 鸿蒙 WuKong 测试报错:Failed to connect to AAMS 的解决方法
一、问题背景
在 HarmonyOS(鸿蒙)应用开发过程中,使用 WuKong(悟空)稳定性测试工具 对应用进行随机事件测试时,执行测试命令后,WuKong 没有正常开始执行,而是直接退出。
控制台出现以下错误:
text
Failed to connect to AAMS
ComponentManager Connect failed
经过排查,最终通过关闭 Windows 本地所有已打开的 CMD 窗口,再重新打开一个新的 CMD 窗口执行测试命令,成功解决了该问题。
下面记录完整的报错信息、分析过程及解决方案。
二、错误日志
执行 WuKong 测试后,控制台输出:
text
Mon Oct 19 20:55:31 2026 : RUN : Interval: 1000
Mon Oct 19 20:55:31 2026 : RUN : Count: 28800
Mon Oct 19 20:55:31 2026 : INF : ( 115) EnvInit : "Report currentTestDir: (/data/local/tmp/wukong/report/20261019_205530/)"
Mon Oct 19 20:55:31 2026 : INF : ( 121) EnvInit : "Report CSV: (/data/local/tmp/wukong/report/20261019_205530/wukong_report.csv)"
Mon Oct 19 20:55:31 2026 : INF : ( 122) EnvInit : "Report JSON: (/data/local/tmp/wukong/report/20261019_205530/data.js)"
Mon Oct 19 20:55:31 2026 : INF : ( 125) EnvInit : "Report exception dir: (/data/local/tmp/wukong/report/20261019_205530/exception/)"
Mon Oct 19 20:55:31 2026 : INF : ( 92) StartCrashDirListen : create listener thread
Mon Oct 19 20:55:31 2026 : INF : ( 94) StartCrashDirListen : thread detach
Mon Oct 19 20:55:31 2026 : INF : ( 68) InitCsvFile : "CSV: (/data/local/tmp/wukong/wukong_20261019_205530.csv)"
Mon Oct 19 20:55:31 2026 : INF : ( 55) ListenCrashDir : init notify
Mon Oct 19 20:55:31 2026 : INF : ( 60) ListenCrashDir : add_watch
Mon Oct 19 20:55:31 2026 : RUN : Seed: 10
Mon Oct 19 20:55:33 2026 : INF : ( 158) Connect : Start connect to AAMS
Mon Oct 19 20:55:33 2026 : ERR : ( 160) Connect : Failed to connect to AAMS
Mon Oct 19 20:55:33 2026 : ERR : ( 137) RunTestCommand : ComponentManager Connect failed
Mon Oct 19 20:55:33 2026 : RUN : catching stopped
exit main
WuKongLogger::~WuKongLogger
2.1 关键报错信息
重点关注以下几行:
text
Connect : Start connect to AAMS
Connect : Failed to connect to AAMS
RunTestCommand : ComponentManager Connect failed
RUN : catching stopped
可以看出,WuKong 在初始化过程中尝试连接 AAMS 服务,但连接失败,进而导致 ComponentManager 初始化失败,最终测试停止。
2.2 日志参数说明
| 参数 | 含义 |
|---|---|
| Interval: 1000 | 随机事件执行间隔为 1000 毫秒 |
| Count: 28800 | 计划执行 28800 次随机事件 |
| Seed: 10 | 随机测试种子 |
| EnvInit | 初始化测试报告目录 |
| StartCrashDirListen | 启动异常日志目录监听 |
| Failed to connect to AAMS | 连接 AAMS 失败 |
| ComponentManager Connect failed | 组件管理器连接失败 |
按照配置的事件间隔计算,28800 × 1000 毫秒约为 8 小时,不包括事件执行本身产生的额外耗时。
但是,从日志可以看到,测试在启动大约 2 秒后就退出了。
这说明问题发生在测试初始化及连接阶段,并非完成随机事件测试后产生的异常。
三、问题原因分析
3.1 AAMS 连接失败
核心错误:
text
Failed to connect to AAMS
WuKong 在执行随机事件测试前,需要连接系统相关服务,以便执行自动化操作。
如果该连接无法建立,就可能出现:
text
ComponentManager Connect failed
最终导致整个测试流程终止。
3.2 可能存在测试进程或连接资源占用
结合本次实际解决过程,怀疑问题可能与以下情况有关:
- 此前启动的 CMD 窗口中仍存在运行中的测试命令。
- 某些测试进程没有正常退出。
- 其他自动化测试程序占用了相关服务连接。
- 设备端或主机端的测试连接状态异常。
需要注意,以上属于可能原因,并非已经确认的根因。
本次没有通过进程列表、系统服务日志等方式进一步定位具体占用者,因此不能直接认定 AAMS 一定被某个 CMD 进程占用。
四、实际解决方案(已验证)
本次采用的解决方法非常简单。
步骤一:关闭所有 CMD 窗口
首先关闭 Windows 本地所有已经打开的 CMD 命令行窗口。
特别是此前执行过以下操作的终端:
- HDC 设备连接命令
- WuKong 稳定性测试命令
- 其他鸿蒙自动化测试相关命令
注意:关闭终端可能会中断正在运行的任务,操作前应确保没有需要保留的测试任务。
步骤二:重新打开 CMD
打开一个新的 Windows CMD 窗口。
步骤三:重新执行 WuKong 测试
在新的 CMD 窗口中,重新运行原先的 WuKong 测试命令。
测试结果:WuKong 成功正常启动,之前的 AAMS 连接报错消失。
整个过程中,没有修改项目代码,也没有重新安装 DevEco Studio、HDC 或 WuKong 工具。
五、其他排查建议
如果关闭 CMD 窗口后,问题仍未解决,可以进一步按照以下顺序排查。
5.1 检查 HDC 设备连接
执行:
bash
hdc list targets
确认设备能够正常被 HDC 识别。
如果设备未出现在列表中,需要先检查 USB 连接、设备调试设置及 HDC 服务状态。
5.2 检查是否存在其他自动化测试任务
检查是否正在运行:
- WuKong 测试
- Hypium 自动化测试
- DevEco Testing 相关工具
- 其他 UI 自动化测试程序
如果存在正在执行的自动化测试任务,先正常停止,再重新运行 WuKong。
5.3 查看设备端 WuKong 进程
可以尝试执行:
bash
hdc shell ps -A | grep wukong
查看设备端是否存在 WuKong 进程。
需要注意,不同系统版本对 ps 和 grep 的支持情况可能存在差异。
5.4 缩小测试规模进行验证
排查连接问题时,没有必要一开始就执行 28800 次随机事件。
可以先执行:
bash
hdc shell wukong exec -a 1000 -c 100
通过少量事件验证测试工具能否正常启动。
如果验证成功,再恢复原先的长时间稳定性测试配置。
5.5 重启设备
如果上述方法均无法解决,可以尝试重启鸿蒙设备。
重启后,先不要运行其他自动化测试工具,直接执行 WuKong,以排除部分测试服务状态异常带来的干扰。
说明:以上是补充排查建议,不代表本次案例实际执行过这些操作。
六、总结
本次 HarmonyOS WuKong 测试遇到的错误为:
text
Failed to connect to AAMS
ComponentManager Connect failed
实际有效的解决办法:
关闭 Windows 本地所有 CMD 窗口,重新打开 CMD,再次执行 WuKong 测试命令,问题解决。
从故障表现来看,问题发生在 WuKong 连接系统服务的初始化阶段,可能与此前的测试进程、连接资源或运行环境状态有关。
但由于没有进一步采集进程占用和服务连接日志,具体根因暂时无法确认。
对于类似问题,建议优先排查测试环境和相关进程,再考虑修改项目代码或重新安装开发工具。
关键词: HarmonyOS、鸿蒙、OpenHarmony、WuKong、悟空测试、AAMS、ComponentManager、HDC、稳定性测试、自动化测试