21 · 告警与短信通知机制（附录）

本篇为机制说明，帮助理解系统自动行为；无需用户操作，但排查「为什么收到 / 没收到短信」时必读。

总览

平台的消息通知分为四类：

一、告警判断流程

系统按采样周期自动检查每台告警类型设备（设备类型标识码为 PRESSURE 水压计、WATER_LEVEL 水位监测设备）的读数：

读取设备实时值
   │
   ├─ 值 < 预警值 ──► 正常：清除计时（若此前在计时中）
   │
   └─ 值 ≥ 预警值 ──► 开始 / 继续计时（按真实时间累计秒数）
                          │
                          ├─ 持续时长 < 设定的持续时间 ──► 继续等待
                          │
                          └─ 持续时长 ≥ 设定值 ──► 检查告警间隔
                                                      │
                                                      ├─ 距上次通知 < 告警间隔 ──► 跳过本次
                                                      └─ 已满间隔 ──► 发送短信，计时重新开始

关键规则：

1. 两级互斥：先判强预警，再判普通预警；强预警触发后本次不再发普通预警，一次读数只发一条。
2. 持续时长：超限必须连续保持到设定秒数才告警；中途恢复正常则计时清零。
3. 计时基于真实时间：与上报频率无关（如持续 180 秒的设置，无论设备 10 秒一报还是 60 秒一报，都按墙钟时间判断）。
4. 周期重发：发送后计时从零重新累计；只要持续超限，每隔 max(持续时间, 告警间隔) 会再次通知。
5. 告警间隔：同一设备同一等级两次通知的最小间隔（秒），必填正整数，默认 3600（1 小时）；间隔内的发送请求直接跳过。
6. 等级独立：普通预警与强预警各自计时、互不干扰（仅发送时强优先）。

二、告警接收人

设备触发告警时，短信发送给以下手机号（合并去重、逐一发送）：

因此：新增项目管理员后立即具备告警接收资格；禁用账号或删除账号即停止接收。接收人异常（如空号）只影响本人，不影响其他人接收。

三、告警短信内容

短信按「等级 + 设备类型」选择模板（模板 ID 在短信配置中维护）：

模板变量顺序固定为：项目名称 | 位置 | 告警时间 | 当前读数值

• 「位置」取该设备在设备标注中填写的安装位置，未标注时显示「-」；
• 「当前读数值」保留两位小数。

示例：【××小区】地下室【3 号楼配电间】排水限压井，2026-06-15 14:30:00 超过限值 1.23 米……

每次告警发送都会写入操作日志（模块：项目设备管理，内容含模板、项目、总人数、成功 / 失败条数），发送失败的原因可在运维监控日志中进一步排查。

四、节日祝福短信

• 触发：每天 09:00 定时任务检查当天（按农历）是否为端午（五月初五）、中秋（八月十五）、春节（正月初一）；
• 开关：短信配置中各「拜节短信」的「自动推送」开关，关闭则当天不推送；
• 接收人：全部状态正常的项目管理员；
• 内容：端午节无变量；中秋、春节短信带项目名称变量；
• 手动补发可使用「雨季提醒」类似的群发能力或等待次年自动推送（节日短信无页面级手动补发入口）。

五、雨季提醒短信

• 触发：管理员在 管理员管理 页面手动发送（见管理员管理）；
• 范围：可指定项目，或全部项目；
• 接收人：所选（或全部）项目状态正常的项目管理员；
• 内容：提醒雨季来临、地下水位上升、做好防汛准备（无变量模板）。

六、数据采集与告警的关系

若采集链路中断（设备离线、速控云配置失效、同步任务停止），读数不再更新，告警也不会触发——「没有短信」不代表「设备正常」，请结合数据统计曲线与设备最新读数时间综合判断。

七、故障排查清单

按顺序检查：

1. 设备最新读数是否仍在更新（设备绑定页 / 数据统计页）；
2. 读数是否真的超过预警值 / 强预警值，且持续满时长；
3. 距上次通知是否未满告警间隔；
4. 该项目是否有状态正常的项目管理员、或开启强制通知的系统管理员；
5. 短信配置中对应模板 ID 是否已配置；
6. 操作日志 中搜索「告警短信」查看发送记录（成功 / 失败条数）。

以上均正常仍未收到时，请联系平台运维检查短信平台与监控日志。