别再自己轮询了,鸿蒙推送服务的接入实录
每三十秒轮询一次的代价
接手消息模块时看到的景象至今难忘:为了不让用户错过消息,客户端在后台每三十秒拉一次未读数。结果是什么?后台耗电榜排名靠前,用户投诉费电,消息平均延迟还是十五秒起步,因为应用一被杀,轮询就停了。这个方案在鸿蒙的后台管控下基本等于自我淘汰。这篇记录换成系统推送通道的完整过程。

▲ 示意图 · 推送服务接入
系统通道和自建通道的差别
先把两种通道的本质区别说清楚。自建长连接只有在应用进程活着时才有效,鸿蒙的应用退到后台几分钟就可能被回收,连接随之断掉,这是设计使然,不是 bug。而系统的推送通道由系统级服务维护,应用进程死没死不影响投递,消息到了由系统拉起通知,用户点击才启动应用。
所以正确的架构是两条腿走路:应用在线时走自建长连接,延迟最低;离线或者被杀时靠系统推送兜底。只押宝任何一边都会出问题。
接入的最小代码
推送服务需要在 AGC 控制台开通,代码侧的入口是获取 token 并上报给服务端。
import { pushService } from '@kit.PushKit';
async function initPush(): Promise<void> {
try {
// token 标识"这台设备上的这个应用"
const token: string = await pushService.getToken();
await reportToken(token); // 上报给业务服务端
} catch (e) {
console.error(`获取 token 失败: ${(e as Error).message}`);
}
}
服务端拿着 token 调推送服务的 REST 接口,指定标题、内容、点击动作,消息就经系统通道到达设备。客户端这边不需要常驻任何东西。
两个必须注意的点。第一,token 不是永久的,卸载重装、恢复出厂都会变化,所以每次应用启动都重新获取并上报,服务端按用户维度更新,别只在首次登录时上报一次。第二,服务端调用推送接口会收到响应码,无效 token 要及时清理,堆着不管不仅浪费配额,到达率统计也会被污染。
点击之后落到哪里
推送通知的点击动作可以配置拉起应用时的参数,和卡片、通知的回流模式一样:onCreate 和 onNewWant 里接参数,跳到对应的消息详情。
onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
const target = want.parameters?.target as string;
if (target === 'message') {
const sessionId = want.parameters?.sessionId as string;
this.jumpToSession(sessionId);
}
}
老毛病再提一次:冷启动和热启动两条路都要接。我们灰度时收到过"点通知进了首页"的反馈,排查发现热启动分支漏了,这种问题单看代码很难发现,要在真机上把两种启动方式都点一遍。
到达率怎么验证
推送的验证必须覆盖三种状态:应用在前台、在后台、被杀进程。自建通道只在前两种状态有效,系统通道三种都能到,测试用例要按这个矩阵过一遍。另外服务端发推送时区分消息类型,即时消息走高优先级,营销内容走普通优先级,系统的投递策略会区别对待,混在一起发,重要的反而可能被排队。
频控也要心里有数,单一用户单位时间内的推送量有上限,超了会被限流。运营活动想一次推给所有人之前,先确认配额,别在高峰时段挤爆。
还有一个降噪手段:合并。用户连发三条消息时,服务端不要推三条通知,把内容合并成"张三发来 3 条消息"推一条,客户端打开后再拉详情。推送数量降下来,打开率反而上去,这是通知体系里反复被验证的规律。
写在最后
这次改造的账目很清楚:客户端轮询代码整个删掉,后台日均耗电降了六成,消息平均延迟从十五秒压到两秒以内,而且应用被杀也不再丢消息。复盘下来就三条经验:别用客户端轮询对抗系统后台管控,方向就是错的;token 每次启动上报,服务端及时清无效;验证按前台、后台、被杀三状态过矩阵。推送是消息类应用的生命线,这条线要接在系统通道上,而不是接在自己的轮询循环里。
更多推荐




所有评论(0)