本页按症状给出排查步骤。设备的停机行为、急停与清故障流程，以及维护要求见维护。SDK 安装、连接与订阅类问题见 Wuji SDK 故障排查。
无法发现设备
- 确认设备已上电，手背状态灯进入白色呼吸
- 确认网线插在设备网口与电脑网口之间，接口无松动
- 确认电脑网卡配到同网段静态 IP，子网掩码
255.255.255.0 ping 192.168.1.110（左手）或ping 192.168.1.111（右手）验证连通- 重新运行
wuji devices
无法连接或 IP 冲突
同一网段接入两台同手性设备时，出厂 IP 相同会冲突。先只接一台，按 SDK 接口的 ip（SET/GET）改掉其中一台的 IP 并重启，再同时接入。状态灯显示告警或故障
按产品介绍的手背状态灯对照灯效确认当前状态，再订阅joint_diagnostics 读取具体错误码，按维护的清故障与安全复位流程处理。
关节离线（在线关节数少于 20）
hand.online_joints_count().get()确认实际在线数- 订阅
joint_diagnostics，用每条的nid定位缺失关节 - 检查该关节是否卡滞、线缆是否受拉
- 断电重启后重新确认。仍缺失时导出日志联系技术支持
使能失败
- 确认无活跃错误码，有则先清故障
- 确认手指工作空间无遮挡、无外力约束
- 重新
hand.enable()并等待状态字进入 Enabled - 反复失败时断电重启后重试
参数写入被拒
effort_limit 与 mit_params 会拒绝 NaN、Inf 与负值，effort_limit 还会拒绝超出设备上限的值。写入被拒时当前生效值保持不变，先读回确认当前值，再在上限内重试，见参数安全边界。