
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 分钟
目录
- 为什么现在要关心
- 问题空间:加厂商别改遍业务
- 心智模型:统一寄件柜台 vs 多家快递
- 精确定义:Provider、策略链、选路输入
- 模式对照:直调、广播、择一成功
- 可复述做法:接口、规则表、伪流程
- 反模式
- 选型结论
为什么现在要关心
硬规则先钉六条,删掉比喻也能复述:
- 业务只依赖 Provider 接口,不依赖某厂商 SDK 类型。
- 按设备选通道:在线可走实时帧;离线走平台推送;无 token 则跳过该 Provider。
- 策略是有序列表,默认不是「全通道广播同一条」(除非产品明确要双响)。
- 同 Provider 有限重试,再降级下一 Provider;重试预算写进合同。
- token / 在线态是选路输入:过期 token 要有失效回路,否则假成功。
- 与三平面一致:系统推送成功 ≠ 消息已同步;进 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/。
精确定义: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. 业务直调厂商 SDK | Service 里 if FCM / APNs | 短平快 | 厂商泄漏;难测;难加通道 |
| B. 全 Provider 并行广播 | 选中列表全部 Push | 「尽量响」 | 双响 / 成本;需去重与产品合同 |
| C. 策略链:择一成功即停 | 排序 Provider,成功返回;失败重试后 next | 可控打扰与成本 | 要定义顺序与重试预算;首条失败带来延迟 |
推荐写清副作用:选 C 时,第一条 Provider 抖动会拉长端到端延迟;预算太紧可能过早落到「更吵 / 更贵」的通道。选 B 时,打扰与厂商计费是确定账单,不是「多一层保险就免费」。
常见默认顺序(教学):
- 设备在线且实时可达 → Realtime Provider(长连接帧)
- 否则 → 平台推送(APNs / FCM 等,按 platform + token)
- 均不可用 → 记失败 / 进短命重试册;真相仍靠 Sync
可复述做法:接口、规则表、伪流程
七步清单:接口 → 信封 → 规则表 → 多设备 → 重试预算 → token 失效 → 观测。
- 定义
PushProvider:Name/CanPush/Push(Batch可选) - 统一
PushMessage信封(title / body / data / priority / ttl / silent) - 写规则表:条件 → Provider 有序列表
- 对用户多设备循环;每设备跑自己的策略链
- 重试:同 Provider 有限次 + backoff;用尽再降级
- token 失效:厂商错误码 → 清 token / 标需重绑
- 观测:按 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 抽象重新揉坏。
-
业务层直接 import 厂商客户端
测不了;加通道要改业务;SDK 升级扩散到全仓。 -
在线仍强制系统推送「双保险」且无产品合同
双响与成本是确定副作用;不是免费稳健。 -
无限重试同一 Provider
积压、延迟、把短暂故障当成永动机。 -
忽略
CanPush,对空 token 空转
假忙;成功率指标失真;假成功污染观测。 -
把 Provider 成功当已读 / 已同步
门铃合同 ≠ Sync 合同。进 App 仍要拉齐;见三平面文。 -
多设备共用一条链、不按设备选路
iOS token 拿去打 Android 通道;或一台在线带动全用户走实时——边界错了。
选型结论
- 默认接口 + 策略链(模式 C):业务只依赖 Provider;广播(B)仅在产品明确要多端同响时显式开启,并接受双响与成本。
- 在线优先实时,离线走平台推送;无 token 则跳过,别空转。
- 同 Provider 有限重试 + backoff,再降级;预算写进合同,避免无限重试。
- token / 在线态是选路输入;无效 token 要失效回路,否则假成功。
- Push-as-hint 不变:Provider 成功 ≠ 消息已同步;进 App 仍走 Sync。与三平面文分工——那边职责边界,本文实现选路与降级。
系列导航:
- 职责边界(三平面 / Push-as-hint):/blog/im_push_priority_channels/
- 历史存证 vs 投递重试册:/blog/im_delivery_retry_vs_history_store/