单板测试正常，整机运行异常：6 类系统排查清单
本文适用于机器人整机联调、跑机测试或现场试运行中的这类问题：
单板测试正常，整机运行异常；
台架上能通信，装机后偶发掉线；
单模块测试无报警，整机带载后报警；
传感器台架数据正常，整机中出现跳变；
上位机日志报通信、超时或状态异常，但根因不明确。
核心判断：单板测试验证的是局部功能，整机测试验证的是系统环境下的稳定性。
一、总排查顺序
顺序 | 排查对象 | 核心问题 |
|---|---|---|
1 | 负载变化 | 异常是否与动作、带载、启动、制动、加减速相关 |
2 | 供电路径 | 最差工况下电源是否稳定 |
3 | 线束和连接器 | 运动、振动、复装后是否存在接触和受力问题 |
4 | 接地和回流路径 | 大电流、信号参考、屏蔽和结构地路径是否清楚 |
5 | 通信链路 | 通信异常是源头，还是供电、接地、线束问题的结果 |
6 | 安装和环境 | 散热、结构、维护空间、传感器姿态是否改变了边界 |
二、排查清单 1：负载变化
检查项 | 需要记录 | 常见风险 |
|---|---|---|
动作时间点 | 异常是否发生在电机启动、制动、转向、加减速瞬间 | 瞬态电流导致压降或干扰 |
负载状态 | 空载、半载、满载下表现是否一致 | 带载后供电余量不足 |
速度条件 | 低速、高速、连续动作是否一致 | 高速工况下线束、控制或供电边界被放大 |
多负载并发 | 是否多个执行器同时工作 | 峰值电流叠加 |
异常前后数据 | 电压、电流、驱动状态、错误计数 | 只看报警点，漏掉前置变化 |
建议动作：
把异常发生时间和具体动作对齐。
做空载/带载、低速/高速、单动作/组合动作对比。
记录异常前后 5-30 秒的供电、通信、驱动和状态数据。
三、排查清单 2：供电路径
检查项 | 需要确认 | 不要只写 |
|---|---|---|
静态电压 | 模块输入端实际电压 | 电源正常 |
动态电压 | 动作瞬间是否压降 | 万用表看着没问题 |
供电路径 | 电源、保护器件、接插件、线束、DC/DC 到模块的路径 | 接上了 |
多负载状态 | 多模块同时工作时电源是否波动 | 单独测过 |
重启/掉线前后 | 电源是否有异常记录 | 后面恢复了 |
现场记录模板：
字段 | 记录内容 |
|---|---|
异常时间点 | |
异常动作 | |
模块输入电压范围 | |
峰值电流/负载状态 | |
是否出现瞬态压降 | |
是否触发保护/重启 | |
关联记录位置 |
四、排查清单 3：线束和连接器
检查项 | 需要确认 | 常见问题 |
|---|---|---|
线束运动状态 | 最大行程、最小行程、转弯、升降时是否受力 | 某姿态下拉紧 |
弯折半径 | 是否满足线缆要求 | 长期弯折导致偶发接触问题 |
固定点 | 扎带、线夹、过孔位置是否合理 | 固定点改变受力 |
连接器锁紧 | 是否完全插到位、是否有防松设计 | 振动下接触不稳定 |
信号/动力线距离 | 是否长距离并行或靠近干扰源 | 耦合干扰 |
维护复装一致性 | 拆装后走线是否可重复 | 复装后问题出现 |
建议动作：
在异常动作对应姿态下检查线束，而不是只在静止状态检查。
轻微晃动线束和连接器，观察通信错误计数、状态字、传感器数据是否变化。
对关键线束拍照留档，作为复装一致性参考。
五、排查清单 4：接地和回流路径
接地排查不要只停留在“接好一点”。建议把回流路径画出来。
路径 | 要画清楚的问题 |
|---|---|
大电流回流 | 电机、驱动、电源的大电流从哪里回去 |
信号参考 | 通信、传感器、控制信号参考点在哪里 |
屏蔽层 | 单端接、两端接、接结构地还是信号地 |
结构地 | 金属结构是否参与回流 |
保护地 | PE 与信号地、电源地关系是否明确 |
模块间地电位 | 不同模块之间是否存在明显地电位差 |
典型误区：
说法 | 风险 |
|---|---|
接地已经接了 | 接了不等于路径合理 |
屏蔽层都接上了 | 接法不一致可能引入新路径 |
台架上没干扰 | 台架地关系和整机地关系不同 |
加一根地线试试 | 可能改善现象，也可能制造环路 |
六、排查清单 5：通信链路
检查项 | 需要确认 |
|---|---|
拓扑 | 总线、星型、分支长度是否符合要求 |
终端 | 终端电阻是否正确，位置是否正确 |
线缆 | 长度、屏蔽、双绞、阻抗是否合适 |
接插件 | 是否可靠锁紧，是否有接触风险 |
错误计数 | 超时、丢包、重连、CRC、bus error 是否变化 |
上下电顺序 | 模块初始化时序是否改变 |
重连机制 | 真实掉线后是否能恢复到一致状态 |
动作关联 | 通信异常是否与某个动作、负载或姿态同步 |
判断原则：通信报错不等于通信协议就是根因。供电波动、地参考变化、线束受力、干扰耦合，都可能表现成通信异常。
七、排查清单 6：安装和环境变化
检查项 | 整机中可能变化 |
|---|---|
散热 | 模块被外壳包住，风道被挡住，靠近热源 |
传感器姿态 | 安装角度、视野、标定状态与台架不同 |
结构应力 | 模块、连接器、线束受到额外应力 |
维护空间 | 连接器插拔不方便，容易插不到位 |
振动 | 整机运动导致板卡、连接器、线束振动 |
环境 | 光照、反射、人员、空间、电磁环境改变 |
八、整机异常记录模板
字段 | 内容 |
|---|---|
问题编号 | |
异常现象 | |
出现时间 | |
任务步骤 | |
动作/负载状态 | |
受影响模块 | |
软件日志摘要 | |
供电数据 | |
通信错误计数 | |
线束/连接器检查结果 | |
接地/回流路径检查结果 | |
安装与环境变化 | |
复现条件 | |
初步假设 | |
下一步验证 | |
负责人 |
九、关闭前检查
关闭条件 | 是否满足 | 证据 |
|---|---|---|
原异常动作已覆盖 | ||
最差负载工况已覆盖 | ||
供电动态数据已确认 | ||
线束运动状态已确认 | ||
接地回流路径已说明 | ||
通信错误计数已对比 | ||
安装、散热、维护状态已确认 | ||
修改动作影响面已验证 |
十、总结
单板测试正常，不等于整机系统边界一定成立。
遇到“台架正常、整机异常”，建议优先排查：
负载变化 → 供电路径 → 线束连接器 → 接地回流 → 通信链路 → 安装环境。
这套顺序的目的不是把问题复杂化，而是避免把系统环境问题误判成单板问题、软件问题或模块质量问题。
