Appearance
常见问题与排查
排查前记录组织、项目、设备、点位和发生时间。截图或提供日志时隐藏密码、安全码与完整 Token。
设备添加失败
核对设备 ID、安全码及目标组织。已经绑定的设备需要由有归属管理权限的所有者处理，不能仅通过重新创建同名项目解决。额度不足时查看套餐用量。
设备离线或数据不更新
依次检查供电、网络、SIM 卡状态、天线和最近连接时间。设备在列表中存在，只说明已绑定；历史连接时间不表示当前仍在线。
设备在线但点位无值时，再检查点位是否启用、串口参数、从站 ID、功能码、地址和数据索引，详见 Modbus 配置。
数值明显不对
| 现象 | 检查项 |
|---|---|
| 相差 10 倍或 100 倍 | 数据比例、单位 |
| 整体偏移 | 数据偏移 |
| 负值或极大值 | 有符号格式、字节序、索引 |
| 多个通道值错位 | 起始地址、寄存器长度及索引 |
先与传感器本地读数或参考仪表对照，再修改参数。不要放宽阈值来掩盖错误读数。
实时有值，历史没有数据
检查查询时间和项目时区、点位创建时间、调试模式及历史存储。实时与历史来自不同保存链路，实时值更新不能证明历史记录已写入。
GPS 没有轨迹
检查该点位是否上报了有效经纬度，所选范围内是否有定位记录，地图是否正常加载。新建 GPS 类型不会自动产生定位数据。
不能修改配置或控制设备
检查角色与项目范围、套餐状态以及设备是否支持对应功能。开放项目的只读访问不会授予控制权限。
控制命令已发送，但设备没有动作
核对目标点位、命令记录、设备在线情况和状态回报，再检查现场接线、执行器、互锁和限位。超时后先查状态，不要连续重复发送。结果含义见控制设备。
定时或联动没有执行
- 查看任务是否启用，目标点位是否仍存在及兼容。
- 定时检查项目时间、触发方式和活动窗口。
- 联动检查条件是否满足、数据是否继续上报、健康状态是否异常。
- 打开执行记录，区分失败、冷却跳过和目标状态已满足。
告警一直未恢复
检查新上报数据是否满足恢复条件。没有新数据、数据过期或设备离线时，不能据此认定已经恢复。标记已知晓只表示人员已看到告警，详见告警状态。
读数刚越界但未出现告警时，检查后续上报。触发和恢复都需要有效数据中的条件保持至少 30 秒，一次短暂变化不会立即改变告警状态。
有站内通知，但没有邮件或短信
检查通知配置是否启用、接收地址和类型是否匹配、投递结果及套餐状态。测试发送和业务消息分别验证；外部发送恢复后不会补发暂停期间消息。
导出失败或文件为空
失败时查看任务错误提示，缩小时间跨度或减少点位；已完成但没有数据时，检查时间范围和历史记录。文件过期后不能继续使用原下载入口，详见数据导出。
数据转发没有收到
先核对配置启用状态及新上报，再检查目标地址、认证和目标系统日志。MongoDB 同时检查以组织标识命名的集合；InfluxDB 检查 Measurement 与时间范围。各通道步骤见数据转发。
API 未授权或找不到资源
401 检查认证和有效期，403 检查角色、范围及套餐，404 核对路径、数值主键和内部标识。先使用只读请求验证，参阅API 集成。