Skip to content

常见问题与排查 ​

排查前记录组织、项目、设备、点位和发生时间。截图或提供日志时隐藏密码、安全码与完整令牌。

设备添加失败 ​

核对设备 ID、安全码及目标组织。已经绑定的设备需要由有归属管理权限的所有者处理,不能仅通过重新创建同名项目解决。

设备离线或数据不更新 ​

依次检查供电、网络、SIM 卡状态、天线和最近连接时间。设备在列表中存在,只说明已绑定;最近连接时间不表示当前仍在线。

设备在线但点位没有数据时,再检查点位是否启用、串口参数、从站 ID、功能码、地址和数据索引。排查步骤见 Modbus 配置参考。

数值明显不对 ​

现象检查项
相差 10 倍或 100 倍数据比例、单位
整体偏移数据偏移
负值或极大值有符号格式、字节序、索引
多个通道值错位起始地址、寄存器长度及索引

先与传感器本地读数或参考仪表对照,再修改参数。不要放宽阈值来掩盖错误读数。

实时有值,历史没有记录 ​

检查查询时间和项目时区、点位创建时间、调试模式及历史存储。实时与历史来自不同保存链路,实时值更新不能证明历史记录已写入。

GPS 没有轨迹 ​

检查该点位是否上报了有效经纬度,所选范围内是否有定位记录,地图是否正常加载。新建 GPS 类型的点位不会自动产生定位数据。

不能修改配置或控制设备 ​

检查用户角色与项目访问权限以及设备是否支持对应功能。开启开放访问的项目只提供只读查看,不授予控制权限。

控制命令已发送,但设备没有动作 ​

核对目标点位、命令记录、设备在线情况和状态回报,再检查现场接线、执行器、互锁和限位。超时后先查状态,不要连续重复发送。结果含义见控制设备。

定时或联动没有执行 ​

  • 查看定时器或规则是否启用,目标点位是否仍存在及兼容。
  • 定时器:检查项目时间、触发方式和活动窗口。
  • 联动规则:检查条件是否满足、数据是否继续上报、健康状态是否异常。
  • 打开执行记录,区分失败、冷却期跳过和目标状态已满足等情况。

参阅定时控制和联动规则。

告警一直未恢复 ​

检查新上报数据是否满足恢复条件。没有新数据、数据过期或设备离线时,不能据此认定已经恢复。标记已知晓只表示人员已看到告警,详见告警状态。

读数刚越界但未出现告警时,检查后续上报。触发和恢复都要求条件在有效上报中持续至少 30 秒,一次短暂变化不会立即改变告警状态。

有站内通知,但没有邮件或短信 ​

检查邮件与短信通知是否启用、接收地址和类型是否匹配,以及投递结果。测试发送和业务消息分别验证;外部发送恢复后不会补发暂停期间的消息。

导出失败或文件为空 ​

失败时查看任务错误提示,缩小时间跨度或减少点位;已完成但没有数据时,检查时间范围和历史记录。文件过期后不能继续使用原下载入口,详见数据导出。

目标系统收不到分发数据 ​

先核对配置启用状态以及是否有新上报,再检查目标地址、认证和目标系统日志。MongoDB 同时检查以组织标识命名的集合;InfluxDB 检查 Measurement 与时间范围。各通道步骤见数据分发。

API 未授权或找不到资源 ​

401 检查认证和有效期,403 检查角色、范围及资源访问条件,404 核对路径、数值主键和内部标识。先使用只读请求验证,参阅开放 API。