内容概览
先给结论
先查链路哪一段：平台无数据时先判断是全站点还是单站点——全站点查平台服务与网络，单站点查现场设备与通信；按"现场传感器→采集器→通信链路→平台接入→数据库→前端展示"逐段定位。
下表汇总本页覆盖的典型故障现象、可能原因数量与排查步骤数量，便于按优先级快速定位。排查顺序遵循"先现场机械/电气，后通信/平台"的通用原则。
| 故障现象 | 可能原因数 | 排查步骤数 | 优先级 |
|---|---|---|---|
| 所有站点都无数据 | 4 | 6 | 高 |
| 单站点无数据 | 4 | 6 | 中 |
| 数据入库延迟（小时级） | 4 | 5 | 中 |
症状、原因与排查步骤
所有站点都无数据
可能原因
- 平台采集服务崩溃或未启动
- 数据库连接异常或磁盘满
- 公网 IP/端口变更，现场设备无法回传
- 现场网关与平台对接密钥过期
排查步骤
- 第 1 步：登录服务器看采集服务进程是否运行
- 第 2 步：查数据库连接与磁盘空间（df -h）
- 第 3 步：服务器本地 curl 平台接入端口，看是否监听
- 第 4 步：公网端口测试（telnet/nc），确认防火墙规则
- 第 5 步：核对最近是否有 IP/域名变更，现场设备需同步更新
- 第 6 步：查看采集服务日志，定位报错模块
处置清单
- 更换件/备件：备用服务器、数据库备份
- 记录项：服务日志、磁盘空间、端口测试结果
- 预防措施：平台监控告警（服务存活、磁盘、数据库连接），定期备份
单站点无数据
可能原因
- 现场采集器故障
- 通信链路中断（4G/LoRa/光纤）
- 传感器全部故障（较少见）
- 该站点在平台配置错误
排查步骤
- 第 1 步：平台查该站点最后上报时间与心跳
- 第 2 步：4G 站点查 SIM 卡状态与信号
- 第 3 步：LoRa 站点查网关在线状态
- 第 4 步：现场远程（若有）看采集器数据本地是否正常
- 第 5 步：必要时派人现场排查
- 第 6 步：核对平台该站点配置（设备 ID、协议、解析规则）
处置清单
- 更换件/备件：备用采集器、备用通信模块
- 记录项：最后上报时间、故障定位段
- 预防措施：重要站点双链路，平台配置变更留痕
数据入库延迟（小时级）
可能原因
- 消息队列拥堵
- 数据库写入慢（索引/锁）
- 采集服务消费滞后
- 现场设备定时上报间隔长
排查步骤
- 第 1 步：看消息队列堆积条数
- 第 2 步：数据库慢查询日志，优化索引
- 第 3 步：采集服务扩容或调并发
- 第 4 步：现场设备查上报间隔
- 第 5 步：必要时降级非关键数据
处置清单
- 更换件/备件：备用采集服务器、扩容磁盘
- 记录项：队列堆积量、慢查询、延迟分布
- 预防措施：平台监控队列长度，重要数据优先通道
常见问题
平台无数据先查哪一段？
先判断范围：全站点无数据→平台侧（服务/网络/数据库）；单站点无数据→现场侧（设备/通信）；局部慢→队列与数据库性能。
怎么定位是现场问题还是平台问题？
现场采集器本地若有数据，说明传感器与采集正常；平台侧看原始消息是否到达，到达而未入库则是解析/数据库问题。
平台多久巡检一次？
建议每日自动巡检（服务存活、磁盘、数据库、最近上报时间），异常即时告警；重要站点每周人工复核。
内容边界与下一步
本手册排查建议为通用工程参考，具体故障以设备说明书与厂商支持为准；涉及电气开盖、登高、带电、辐射等安全事项，须由持证专业人员操作。
