故障排除

常见问题和解决方案。

连接问题

USV 无法连接

症状: 无法连接到 USV 设备

可能原因:

1. 网络连接问题
2. 防火墙阻止
3. USV 未开机或电量不足

解决方案:

# 检查网络连接
jhusv network check

# 测试连接
ping <usv-ip-address>

# 检查防火墙
sudo ufw status

# 检查设备状态
jhusv device status

频繁断线

症状: USV 频繁断开连接

解决方案:

• 检查信号强度
• 更换通信模块
• 检查电源供应

GPS 问题

GPS 信号弱

症状: GPS 定位不准确或无法定位

解决方案:

# 检查 GPS 状态
jhusv sensors check gps

# 重新校准
jhusv calibrate gps

# 等待 GPS 锁定（通常需要 1-2 分钟）

RTK 无法连接

症状: RTK 基站连接失败

解决方案:

1. 检查网络连接
2. 验证 RTK 基站配置
3. 确认账号权限

传感器问题

传感器数据异常

症状: 传感器返回异常数据

解决方案:

# 校准传感器
jhusv calibrate sensors

# 检查传感器连接
jhusv sensors check

# 查看传感器日志
jhusv logs sensors

任务执行问题

任务无法启动

症状: 任务创建后无法启动

可能原因:

1. 任务配置错误
2. USV 状态不符合要求
3. 系统资源不足

解决方案:

# 验证任务配置
jhusv mission validate mission.yaml

# 检查 USV 状态
jhusv device status

# 查看系统日志
jhusv logs system

任务中断

症状: 任务执行过程中意外中断

解决方案:

1. 检查电池电量
2. 查看事件日志
3. 检查是否触发安全限制

# 查看任务日志
jhusv mission log <mission_id>

# 查看事件
jhusv events list --filter mission

性能问题

系统响应慢

解决方案:

# 检查系统资源
jhusv system status

# 清理缓存
jhusv cache clear

# 优化数据库
jhusv database optimize

数据问题

数据丢失

症状: 部分数据缺失

解决方案:

1. 检查存储空间
2. 查看备份
3. 检查云同步状态

# 检查存储空间
jhusv storage status

# 恢复备份
jhusv backup restore <backup_file>

# 同步云端数据
jhusv cloud sync

获取帮助

如果问题仍未解决：

1. 📖 查看完整文档
2. 💬 访问官方网站
3. 📧 联系技术支持: support@jhusv.com
4. 🐛 报告 Bug

诊断工具

系统诊断

# 运行完整诊断
jhusv doctor

# 生成诊断报告
jhusv doctor --report diagnostic_report.txt

日志收集

# 收集所有日志
jhusv logs collect --output logs.tar.gz

# 发送给技术支持
jhusv support send-logs logs.tar.gz