首页 / Java 平台(cloud-java) / notify 通知

职责概览

通知模块 独立端口 48100,管理站内信、移动推送与发送任务:消息创建、消息任务状态跟踪、推送 Token 管理与 App 推送接口。

与 system 模块的通知模板/站内信接口互补:notify 侧重发送任务与移动推送,system 侧重模板配置。

接口清单

分组Controller说明
消息NotifyMessageController通知消息管理
消息任务NotifyMessageTaskController发送任务状态跟踪
推送 TokenNotifyTokensController移动推送 Token 注册与失效管理
App 推送AppMobilePushControllerApp 端推送注册/触发

关键实现

  • 发送任务:消息创建后生成消息任务,异步发送并跟踪状态(待发送/成功/失败/重试)。
  • RocketMQ 事件:站内信创建、移动推送发送通过 RocketMQ 事件驱动,失败进重试。
  • 推送 Token:按用户维护 APNs/FCM Token,失效 Token 标记并清理。
告警触达依赖 notify 消息任务状态,而不是仅依赖告警记录;排查"告警未送达"时先看消息任务状态与 Token 有效性。

数据与维护注意

核心表:notify_*(3 张):消息、消息任务、推送 Token。

  • 推送 Token 属敏感数据,日志脱敏。
  • 发送任务必须幂等:同一消息不得重复发送(任务状态 + 唯一约束)。