常见问题

本文整理设备接入、点位配置、数据查看、导出和转发中的常见问题。

设备添加成功，但没有数据

优先检查：

• 设备是否供电
• 设备网络是否正常
• 设备是否在线
• 设备是否绑定到正确项目
• 点位是否已配置并启用
• Modbus 从站地址、功能码和读取地址是否正确
• 设备是否处于调试模式

设备一直离线

可能原因：

• 设备未上电
• SIM 卡、网络或路由不可用
• 设备没有正常发送心跳
• 设备被移动到其他项目或组织
• 设备现场信号弱

建议先确认设备供电和网络，再查看最近连接时间。

点位没有显示值

可能原因：

• 点位未启用
• 设备没有上报该点位数据
• 点位类型或 Modbus 参数配置错误
• 从站地址冲突
• 传感器接线错误
• 传感器通信参数与设备不一致

数值明显不对

常见表现和检查项：

现象	检查项
数值差 10 倍或 100 倍	缩放系数
数值整体偏高或偏低	偏移量
数值巨大、负数异常	数据格式、字节序
温度湿度互换	数据索引
某几个点位错位	读取地址、数据索引

详见 Modbus 配置。

实时数据有值，历史数据没有

可能原因：

• 历史查询时间范围不正确
• 点位刚创建，没有历史记录
• 设备曾处于调试模式
• 历史存储链路尚未写入
• 点位被禁用、删除或重新配置

实时数据只表示最新值，不一定代表历史数据已完整保存。

GPS 没有轨迹

可能原因：

• 没有配置 GPS 点位
• GPS 数据没有有效经纬度
• 查询时间范围内没有数据
• 设备在室内或信号弱
• 地图服务不可用

数据导出任务失败

优先检查：

• 时间范围是否正确
• 是否选择了设备和点位
• 所选点位是否有历史数据
• 导出范围是否过大
• 下载任务是否已完成

如果导出文件为空，可能只是该时间范围内没有数据。

数据转发没有收到

优先检查：

• 转发配置是否启用
• 目标地址、账号或密钥是否正确
• 外部系统是否允许平台访问
• 外部系统是否接受当前数据格式
• 设备是否确实在上报新数据
• 是否只配置了错误的 Topic、Collection 或 Bucket

API 返回未授权

检查：

• Authorization 是否使用 Bearer <ACCESS_TOKEN> 格式
• Token 是否已过期
• Token 是否被禁用或删除
• X-Organization-Slug 是否正确
• Token 是否有对应项目权限

控制命令没有生效

可能原因：

• 设备离线
• 点位不是控制类型
• 控制通道配置错误
• 设备没有正确处理命令
• 现场执行器故障
• 权限不足

控制类设备应先在安全环境下测试，确认硬件互锁、限位和急停保护正常。