蜂控自动化失败怎么排查?先找失败步骤,再决定要不要重试
设备在线不代表任务条件齐全,超时也不代表操作没有发生。用设备连接、流程起点、执行记录三个层次定位问题,并整理能让支持人员直接排查的故障报告。
遇到自动化失败,先别连续点“重试”。保留第一次错误、确认最后一个成功步骤,再区分设备连接问题与业务流程问题。 尤其是发送、提交、安装或修改配置,先查结果再重跑,避免同一动作执行两遍。
本文是蜂控的排查方法指南,不是某次故障的根因报告。2026 年 9 月 9 日核对了相关实现与只读应用资源样本;没有操作设备、运行脚本或复现故障。不同客户端版本的诊断字段可能不同。
先分清:连不上,还是流程走不下去?
同一句“没有反应”,可能指三个不同阶段:
| 看到的现象 | 优先保留的证据 | 下一步判断 |
|---|---|---|
| 设备不出现、画面取不到 | 连接方式、时间、故障检测报告 | 问题是否在设备通道或画面链路 |
| 有画面,但操作停在某一步 | 当前页面、最后成功步骤、第一条错误 | 起点、登录、权限或目标是否变化 |
| 提示超时,但手机好像已经完成 | 原任务标识、执行状态、实际业务结果 | 是否只是响应丢失或等待时间到期 |
不要用“串流能打开”证明脚本一定能完成,也不要用“脚本失败”直接证明手机掉线。一次连接检测只能说明它实际检查的链路和时刻,不能替整个任务验收。
设备故障检测报告解决什么?
屏幕墙设备右键菜单里的“调试与日志 → 故障检测”用于查看连接层面的检查结果。检查完成后,可以使用“复制报告”保留明细,而不只是截一张“异常”的提示。
当前报告实现包含检测时间、逐项结果及耗时、设备与连接上下文;后端有记录时还会包含运行或启动过程。某段日志为空,不能反推那一步从没执行过。故障检测正常而任务失败时,应继续看任务所需页面和执行记录,不要反复重启服务碰运气。
复制报告会对常见令牌和密码做脱敏,但不等于报告适合公开发布。设备标识、地址、路径和业务文本仍可能敏感。发给可信支持人员前先检查,公开提问只保留必要的脱敏片段。
任务的“起点”经常被忽略
一个流程可能假定已经登录、停在某个页面、没有弹窗,并且需要某个配套脚本。本次查看的应用技能样本中确实存在脚本依赖关联;依赖标记为 ready,只能说明相应资源状态,不能证明手机上的业务条件已经成立。
排查时写清四项:
- 预期起点:流程原本要求从哪一页开始?
- 实际起点:报错前真实显示什么?
- 最后成功动作:哪一步有可核对的结果?
- 第一个分歧:哪个目标没出现、哪个状态没改变?
“点完之后等三秒”不一定比“等到目标状态出现,超过上限就停”可靠。Selenium 的官方等待文档解释了页面与自动化执行速度不同造成的竞争,以及固定休眠过短或过长的问题。这里借用的是等待条件的设计思路,不是让你把 Selenium API 当成蜂控脚本接口。等待策略说明
具体可用的状态检查方法,以当前蜂控脚本文档为准。找不到可靠条件时,先安排人工确认,不要用无限等待掩盖问题。
查执行结果,别只看最后一句 AI 回复
对于提供异步任务标识的接口,保留原 taskId,按客户端文档读取它的状态和结果。当前脚本任务查询实现区分状态、是否结束、错误、结果和过程日志,并标记日志是否截断。不要因为只拿到了最后几行,就当成完整执行过程。
如果是外部 AI 或业务系统调用蜂控,先给它当前版本的文档,并要求“只读取已有任务,不重新提交”。可参考外部 AI 接入蜂控。
结果尚不明确时,尤其不要重发可能产生副作用的请求。AWS 的工程资料指出,超时不保证副作用没有发生,重试也可能增加已过载服务的压力。这个原则适用于排查思路,不代表蜂控每个操作都自带幂等保障。超时与重试说明
一份比“又失败了”更有用的反馈
可以按下面的模板整理,示例不是实际用户记录:
客户端版本:填写实际版本。
发生时间:日期、时刻和时区。
范围:一台还是多台,连接类型是什么。
目标:原本希望得到什么结果。
起点:当前页面、必要权限和登录状态。
最后成功步骤:写明证据。
首次错误:保留原文,先脱敏。
实际结果:有没有产生提交、发送或配置变化。
附件:诊断报告、相关任务记录、必要截图。
已尝试:每次改了什么,现象是否变化。
这样支持人员能先确定“在哪一层、哪一步、什么时间”,而不是从一句报错猜完整过程。后续需要复现时,再选择一台获准设备、一个低风险步骤,一次只改变一个条件。如何把验证过程整理成脚本,见AI 写蜂控脚本的小步骤方法。