1. 背景
机器人偶发掉线和误报警，不要只从软件开始改。软件日志看到的可能只是结果，真正的触发点可能在供电接地、通信线束连接器、传感器和现场环境这些链路上。
这份清单适用于机器人联调、跑机测试、现场试运行中出现的以下问题：
模块偶发掉线，重启后恢复；
运行中突然误报警，清除后继续正常；
软件日志显示通信超时、离线、状态异常；
上层看起来像软件问题，但无法稳定复现；
调整阈值或加延时后，报警暂时减少，但根因不明确。
核心原则：软件日志看到的可能只是结果，不能直接等同于根因。
2. 第一响应原则
现场动作 | 建议 | 原因 |
|---|---|---|
立即重启模块 | 谨慎 | 可能清掉关键现场状态 |
立即放宽阈值 | 谨慎 | 可能压住报警但保留物理风险 |
立即修改代码 | 谨慎 | 可能把系统链路问题软件化 |
保存前后数据 | 推荐 | 偶发问题的价值在报警前后的状态变化 |
对齐多源证据 | 推荐 | 判断谁先异常、谁后报警 |
单变量验证 | 推荐 | 避免多个动作同时改变后无法判断效果 |
3. 现象定义模板
字段 | 记录内容 | 示例 |
|---|---|---|
问题编号 | 编号 | ISSUE-XXX |
现象类型 | 掉线 / 误报警 / 超时 / 离线 / 状态异常 | 运行中模块离线 |
发生时间 | 具体时间点 + 时间范围 | 14:32:18，前后各 60 秒 |
任务步骤 | 当时机器人正在做什么 | 抓取后回撤 / 导航避障 / 急停恢复 |
机器人姿态 | 是否在特殊位置或运动边界 | 机械臂伸展到右侧极限附近 |
负载状态 | 空载 / 满载 / 负载突变 | 满载启动后 3 秒 |
人工操作 | 急停、复位、插拔、切模式、拖动 | 发生前 2 分钟切过任务模式 |
恢复方式 | 自动恢复 / 重启 / 清报警 / 插拔 | 重启模块后恢复 |
证据记录 | 日志、波形、视频、截图的脱敏编号或归档记录 | EVIDENCE-XXX |
当前状态 | 未复现 / 待验证 / 已定位 / 观察中 | 待复现 |
4. 三条链路排查总表
链路 | 软件看到的现象 | 可能的系统源头 | 要查的证据 |
|---|---|---|---|
供电 / 接地 | 通信超时、模块复位、离线 | 电压瞬态跌落、峰值电流、接地不一致、屏蔽变化 | 电压/电流记录、驱动报警、模块重启时间、接地检查 |
通信 / 线束 / 连接器 | 丢包、重连、周期抖动、离线 | 线束受力、连接器未锁紧、布线路径受干扰、振动导致接触不稳 | 通信统计、线束姿态照片、连接器锁紧状态、运动位置 |
传感器 / 环境 | 误报警、数据跳变、异常判断 | 安装偏差、视野遮挡、反光、振动、标定漂移、环境变化 | 原始数据、现场视频、安装照片、环境条件记录 |
5. 供电与接地链路检查表
检查项 | 追问 | 记录 |
|---|---|---|
电压瞬态 | 异常前后电压是否有跌落？ | |
峰值电流 | 是否发生在电机启动、负载突变、高速动作时？ | |
模块复位 | 掉线模块是否有重启记录？ | |
驱动状态 | 驱动是否有短暂报警或保护？ | |
接地一致性 | 样机、整机、现场接地是否一致？ | |
屏蔽状态 | 屏蔽层连接是否变化？维护复装后是否一致？ | |
供电路径 | 电源线、端子、保险、开关、连接器是否有接触风险？ |
6. 通信、线束与连接器链路检查表
检查项 | 追问 | 记录 |
|---|---|---|
通信统计 | 是否有超时、丢包、重连、周期抖动？ | |
运动姿态 | 问题是否只在某个姿态或位置出现？ | |
线束受力 | 线束在该姿态下是否被拉紧、弯折、摩擦？ | |
连接器锁紧 | 是否完全插到位？锁扣是否可靠？ | |
振动影响 | 高速运动或振动时是否更容易出现？ | |
布线路径 | 通信线是否靠近强电、驱动、电机线或干扰源？ | |
复装一致性 | 拆装、换件后线束路径是否变化？ |
7. 传感器与现场环境链路检查表
检查项 | 追问 | 记录 |
|---|---|---|
原始数据 | 报警前数据是突然跳变还是逐渐漂移？ | |
安装状态 | 传感器角度、高度、固定方式是否稳定？ | |
标定状态 | 最近是否重新标定？标定条件是否一致？ | |
视野遮挡 | 是否有人、工装、线束、结构件遮挡？ | |
光照反光 | 是否有强光、反光、阴影变化？ | |
振动冲击 | 是否在振动、急停、碰撞边缘后出现？ | |
环境差异 | 实验室和现场条件是否不同？ |
8. 改阈值前确认表
在放宽超时时间、放宽检测阈值、延后报警条件之前，建议先完成以下确认。
确认项 | 判断问题 | 结论 |
|---|---|---|
触发原因 | 阈值为什么被触发？ | |
正常工况 | 当前反馈是否属于正常工况变化？ | |
异常链路 | 是否存在供电、线束、连接器、传感器安装问题？ | |
风险影响 | 放宽阈值后，会不会放过真实风险？ | |
对比数据 | 修改前后是否有同条件数据对比？ | |
回归范围 | 是否验证其他任务和安全边界没有被影响？ |
判断建议
情况 | 是否适合调阈值 | 说明 |
|---|---|---|
正常任务节拍变化导致反馈周期变长 | 可以 | 属于工况边界重新定义 |
负载变化后检测条件需要重新标定 | 可以 | 需要保留修改依据和回归记录 |
供电跌落导致模块复位 | 不建议只调阈值 | 应先解决供电链路 |
连接器接触不稳定导致离线 | 不建议只调阈值 | 应先解决物理连接 |
传感器安装松动导致数据跳变 | 不建议只调阈值 | 应先解决安装一致性 |
通信干扰导致随机丢包 | 不建议只调阈值 | 应先排查布线、屏蔽和接地 |
9. 证据采集要求
证据类型 | 建议范围 | 用途 |
|---|---|---|
软件日志 | 报警前后至少 60 秒 | 看状态切换和报警顺序 |
通信记录 | 报警前后至少 60 秒 | 看超时、丢包、重连 |
供电数据 | 报警前后至少 60 秒 | 看电压跌落、电流峰值 |
传感器原始数据 | 报警前后至少 60 秒 | 看数据跳变、遮挡、漂移 |
现场视频 | 覆盖异常前动作和恢复动作 | 对齐姿态、人工操作、环境变化 |
线束照片 | 异常姿态下拍摄 | 看受力、弯折、摩擦、连接器状态 |
版本和参数 | 修改前后脱敏记录 | 支持回归和复盘 |
10. 单变量验证表
验证轮次 | 本轮只改变的条件 | 保持不变的条件 | 观察指标 | 结果 | 下一步 |
|---|---|---|---|---|---|
1 | 重新锁紧连接器 | 软件版本、参数、任务不变 | 是否仍掉线 | ||
2 | 调整线束固定点 | 软件版本、参数、任务不变 | 通信超时次数 | ||
3 | 加供电记录 | 软件版本、参数、线束不变 | 电压是否跌落 | ||
4 | 调整阈值 | 任务、线束、供电条件不变 | 报警频率和真实风险 |
注意：不要在同一轮里同时改参数、换线、重启模块、调整传感器和更新软件。否则问题不出现了，也无法判断真正有效的动作是什么。
11. 复盘判据
建议满足以下条件后，再考虑把偶发掉线或误报警从“待排查”转为“观察中”或“已定位”。
复盘项 | 判据 | 是否满足 |
|---|---|---|
现象定义清楚 | 已明确是掉线、误报警、超时、离线还是状态异常 | |
触发条件清楚 | 已记录任务、姿态、负载、操作、环境 | |
证据链完整 | 软件、通信、供电、传感器、视频至少能对齐主要时间线 | |
根因或主导因素明确 | 已确认主要来自软件、供电、通信、线束、连接器、传感器或环境中的哪一类 | |
修改动作有依据 | 修改前后有对比，不是只凭“后面没再出现” | |
单变量验证完成 | 关键修改动作经过单变量验证 | |
回归覆盖完成 | 原触发条件和相关任务边界已回归 | |
风险未被掩盖 | 没有通过放宽阈值掩盖物理风险 |
12. 总结
偶发掉线和误报警，不是不能改软件，而是不能只因为软件日志里看到了异常，就直接把问题当成软件问题。
更稳妥的排查顺序是：先保留现场证据，再看三条链路，确认触发原因，最后再决定是否改软件。
