推送别写死一家:Provider 抽象与在线优先降级链

推送别写死一家:Provider 抽象与在线优先降级链

Hello,我是小兔大白糖。 「统一调一下 Push」——底下却把 FCM 写进业务 Service,iOS 再复制一份,在线 WebSocket 又是第三条 if。写成这篇,给要做多通道推送选路与降级调研的初中级后端同学:不是某仓库的推送改造工单,而是业界可复述的 Provider 抽象与策略链心智模型。

说明:FCM / APNs / WebSocket 等为公开举例;「Realtime Provider」泛指长连接帧投递(WebSocket / MQTT / 自研均可),不钉死某一实现。模式 A/B/C 与接口名为教学分析框架。示例均为脱敏示意;未枚举厂商错误码——落地以当前官方文档为准。三平面职责边界见 /blog/im_push_priority_channels/——那边管「Sync / Realtime / Notification 各干什么」;本文管「怎么选通道实现与降级」。Push 仍是 hint,不替代 Sync。

估计阅读时间:10 分钟


目录


为什么现在要关心

硬规则先钉六条,删掉比喻也能复述:

  1. 业务只依赖 Provider 接口,不依赖某厂商 SDK 类型。
  2. 按设备选通道:在线可走实时帧;离线走平台推送;无 token 则跳过该 Provider。
  3. 策略是有序列表,默认不是「全通道广播同一条」(除非产品明确要双响)。
  4. 同 Provider 有限重试,再降级下一 Provider;重试预算写进合同。
  5. token / 在线态是选路输入:过期 token 要有失效回路,否则假成功。
  6. 与三平面一致:系统推送成功 ≠ 消息已同步;进 App 仍要 sync。

现场里常见的误伤,几乎都来自「业务直调厂商」或「默认全开广播」:

你看到的现象常见真相
加一家厂商要改遍业务无 Provider 边界;SDK 类型泄漏到 Service
人明明在线,还狂打 FCM策略未看 IsOnline / 实时可达
双端同一条消息响两次默认 fan-out 全 Provider,无产品合同
「推成功了」用户没消息把 Push 当 Sync;或 token 无效仍记成功

和三平面文对齐一句:门铃响了 ≠ 账本对齐。 本文不重讲定档;只讲门铃走哪家、失败换哪家。


问题空间:加厂商别改遍业务

统一入口 + 适配器 + 有序策略,比在业务里堆厂商 if 更稳。

多通道推送至少要同时回答三件事:

问题不拆会怎样
业务怎么发,才不绑死厂商?换 SDK / 加通道 = 改业务 + 改测试
这台设备此刻该走实时还是系统推送?在线仍打 FCM;或离线空转实时帧
这家失败了怎么办?无限重试同一家;或立刻全开双响

投递重试册与历史存证怎么拆,见 /blog/im_delivery_retry_vs_history_store/——那边管「出生证明 vs 快递面单」;本文的降级链是面单上怎么换承运商,不是把重试字段塞进聊天历史。


心智模型:统一寄件柜台 vs 多家快递

统一「寄件」柜台收业务;多家快递公司是适配器;调度员按是否在岗选路;这家拒收换下一家。

类比含义
统一寄件柜台UnifiedPush / 业务入口
多家快递公司适配器PushProvider 实现(FCM / APNs / 实时帧…)
调度员按是否在岗选路StrategySelector(在线 / 平台)
这家拒收换下一家fallback chain(有序降级)

类比局限:解释选路与抽象边界;解释不了厂商折叠、配额、证书轮换、系统侧静默丢弃——那些是通道上限,不是策略链能「调通」的。

后端类比:像连接池对外只暴露 Get / Put,池内才知道是哪家驱动;业务不该 import 具体驱动类型。接口归属的通用讨论见 /blog/go_interface_provider_vs_consumer/。

业务入口经策略链择一成功降级
业务入口经策略链择一成功降级 · 点击查看 SVG 原图

精确定义:Provider、策略链、选路输入

Provider 是「能不能推、怎么推」;策略链是「按什么顺序试」;选路输入是设备态,不是业务心情。

PushProvider(教学接口)

最小合同通常就三块(名字可换,语义别丢):

能力人话备注
Name这家叫什么观测与规则表用
CanPush(device)这台设备现在能不能走我无 token / 不支持平台 → false
Push(device, msg)真正投递可选 Batch;教学向即可

业务依赖的是上述角色,不是某厂商客户端具体类型。

PushMessage 信封(教学)

统一信封,避免每个 Provider 各吃一套业务 DTO:

字段(示意)用途
title / body展示摘要(Push-as-hint 时可极简)
data自定义键值;进 App 后常靠 sync 补全
priority / ttl与产品合同对齐;过期别无限重试
silent静默戳醒 vs 可见通知

字段名为教学示意,不是某厂必填清单。

选路输入(按设备)

输入影响
platform选 APNs / FCM / 其它平台通道
online / 实时可达是否优先实时 Provider
tokens[provider]CanPush;空则跳过
能力标志是否允许静默推、是否禁用系统通知等

硬规则:token 失效要有回路(清 token / 标需重绑)。厂商返回「无效注册」却仍记成功,等于策略链在空转。

策略链 ≠ 广播

  • 策略链(择一成功即停):有序试 Provider;成功 break;失败用完该家重试预算再 next。
  • 广播(fan-out):对选中列表全部 Push——「尽量响」,但默认双响与成本更高。

默认调研取向是前者;营销类「多端都要响」才显式选后者,并写进产品合同。


模式对照:直调、广播、择一成功

调研默认:在线优先实时 Provider → 平台推送的模式 C;广播类另议 B。

模式做法优点代价
A. 业务直调厂商 SDKService 里 if FCM / APNs短平快厂商泄漏;难测;难加通道
B. 全 Provider 并行广播选中列表全部 Push「尽量响」双响 / 成本;需去重与产品合同
C. 策略链:择一成功即停排序 Provider,成功返回;失败重试后 next可控打扰与成本要定义顺序与重试预算;首条失败带来延迟

推荐写清副作用:选 C 时,第一条 Provider 抖动会拉长端到端延迟;预算太紧可能过早落到「更吵 / 更贵」的通道。选 B 时,打扰与厂商计费是确定账单,不是「多一层保险就免费」。

常见默认顺序(教学):

  1. 设备在线且实时可达 → Realtime Provider(长连接帧)
  2. 否则 → 平台推送(APNs / FCM 等,按 platform + token)
  3. 均不可用 → 记失败 / 进短命重试册;真相仍靠 Sync
在线优先实时,离线走平台推送
在线优先实时,离线走平台推送 · 点击查看 SVG 原图

可复述做法:接口、规则表、伪流程

七步清单:接口 → 信封 → 规则表 → 多设备 → 重试预算 → token 失效 → 观测。

  1. 定义 PushProvider:Name / CanPush / Push(Batch 可选)
  2. 统一 PushMessage 信封(title / body / data / priority / ttl / silent)
  3. 写规则表:条件 → Provider 有序列表
  4. 对用户多设备循环;每设备跑自己的策略链
  5. 重试:同 Provider 有限次 + backoff;用尽再降级
  6. token 失效:厂商错误码 → 清 token / 标需重绑
  7. 观测:按 Provider 成功率、降级率、双通道命中率(若开了 B)

教学向伪流程(脱敏,非生产 API):

push_to_user(user, msg):
  for device in devices(user):
    providers = select_chain(device)  # e.g. realtime if online else platform
    for p in providers:
      if not p.CanPush(device): continue
      if try_with_retries(p, device, msg): break

规则表示意(条件 → 有序列表):

设备条件Provider 链(教学)
online + 实时可达Realtime →(可选)平台推送
offline + 有平台 token平台推送(按 platform)
无 token、无实时跳过推送;依赖 sync / 重试册策略

「可选平台推送」若在 online 仍打,等于隐性双响——要产品明确同意,别当默认。

重试预算人话一句:同一家快递最多敲门 N 次;再不收,换下一家,而不是永远按同一门铃。 无限重试同一 Provider,会把短暂故障放大成队列积压与延迟雪崩。


反模式

从选路视角看,下面几条会把 Provider 抽象重新揉坏。

  1. 业务层直接 import 厂商客户端
    测不了;加通道要改业务;SDK 升级扩散到全仓。

  2. 在线仍强制系统推送「双保险」且无产品合同
    双响与成本是确定副作用;不是免费稳健。

  3. 无限重试同一 Provider
    积压、延迟、把短暂故障当成永动机。

  4. 忽略 CanPush,对空 token 空转
    假忙;成功率指标失真;假成功污染观测。

  5. 把 Provider 成功当已读 / 已同步
    门铃合同 ≠ Sync 合同。进 App 仍要拉齐;见三平面文。

  6. 多设备共用一条链、不按设备选路
    iOS token 拿去打 Android 通道;或一台在线带动全用户走实时——边界错了。


选型结论

  1. 默认接口 + 策略链(模式 C):业务只依赖 Provider;广播(B)仅在产品明确要多端同响时显式开启,并接受双响与成本。
  2. 在线优先实时,离线走平台推送;无 token 则跳过,别空转。
  3. 同 Provider 有限重试 + backoff,再降级;预算写进合同,避免无限重试。
  4. token / 在线态是选路输入;无效 token 要失效回路,否则假成功。
  5. Push-as-hint 不变:Provider 成功 ≠ 消息已同步;进 App 仍走 Sync。与三平面文分工——那边职责边界,本文实现选路与降级。

系列导航: