背景
为了提升推送的到达率,MPS集成了华为、小米等厂商的推送功能,从而有效地提高用户留存率,提升用户体验。在我们日常运维过程中,发现少部分设备在厂商push下无法push,在此分享下相关案例的排查过程,方便后续同类问题借鉴。
2.实现原理
1)push整体架构
以接触最多的国内Android设备为例,整体结构如图1-1所示。
图1‑1 Android PUSH介绍
2)厂商push和自建push
厂商push通道:优点是通过各个OS厂商维护的长链接进行推送,在App被系统杀掉后也可以进行推送,推送到达率高于自建push。支持华为,小米,oppo,vivo等厂商。缺点是,目前厂商的push基本都只支持通知栏消息的推送,在用户点击通知前,不启动应用,对红点, 图片等消息格式支持有限。
自建push通道:通过App启动后和自建服务端的长连接通道实现推送,缺点也很明显,App被杀掉后,就无法收到信息。主要用于不支持厂商渠道场景下的push。
3 问题排查举例
通过上面的介绍,可以看出三方厂商push是否成功,主要取决于三个链路,分别为:
(1)三方token正确生成上报;
(2)服务端正常转发到厂商服务器;
(3)下发到客户端消息可以正常显示。
1)测试准备
为了快速验证问题,我们需要准备一个推送程序,可以快速推送信息到App上。MPS提供了推送的Http接口供外部调用,我们可以通过初始化一个简单的java程序实现推送信息的发送,方便联调。
2)三方token生成阶段
目前MPS对三方厂商push的token生成分为以下步骤。
(1)设备在三方push的厂商列表里
以华为设备为例,判断是否是华为设备的标准是,检测当前手机是否是emui, 如果是才走华为PUSH SDK。在我们日常运维的case中,发现过部分设备由于刷机或者其他操作,在华为手机上安装的不是emui,类似这种设备是走不了华为push的,只能走自建push。
以vivo设备为例,低版本手机只有在vivo公布的白名单设备内才支持推送。名单如图6-6所示。
图1‑2 OPPO推送支持设备列表
(2)生成三方token
在调用push sdk生成token的过程中,由于push sdk的生成也依赖当前手机的room版本,以华为为例,就强依赖华为手机内置的HMS Core版本。针对这种场景下的问题,在获取三方token失败的时候,会在回调里返回对应错误码。如图1-3所示,搜索push的关键字mPush14, 然后过滤,可以获取token返回错误码2。
图1‑3 push日志
我们查看华为定义的错误码,发现2表示SERVICE_VERSION_UPDATE_REQUIRED,需要升级当前的HMS版本,如图1-4所示。
图1‑4 huawei push日志
升级HMS版本的方案有两个:
方案1: 主动升级:调用更新服务接口,升级更新效果如图1-5所示,升级代码如下所示。
if(HuaweiApiAvailability.getInstance().isHuaweiMobileNoticeAvailable(context) == ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED) {
// 需要升级
HuaweiApiAvailability.getInstance().resolveError(activity, ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED, 1);
}
图1‑5 hms升级示意图
方案2: 引导用户去华为设置里去升级HMS, 参考华为官网链接
https://consumer.huawei.com/cn/support/content/zh-cn04461342/
(3)三方token正常上报
生成token后会通过RPC接口上报到MPS服务端,需要检查RPC接口是否有异常,上报接口是:alipay.client.yunpushcore.device.report,日志如图1-6所示。
图1‑6 report调用示意图
(4)token过期
以oppo为例,是在应用第一次启动时注册生效,后在刷机、还原手机(设置-其他设置-还原手机)、卸载应用时会失效,需要重新注册才能推送。如图1-7所示。
图1‑7 token过期说明
3)服务端投送阶段
(1)消息包含了红点,静默,群发
目前如果消息设置了红点或者静默,因为厂商push不支持,MPS会自动走自建push。
(2)三方服务端报错
这种主要用作mPaas服务端推送到三方服务端后,三方返回异常。这种需要去MPS拉取服务端报错日志,然后核对厂商文档解决,比如华为服务端报错文档链接如下:链接。
(3)三方服务端限流
以vivo为例,默认推送走的是运营消息,每天只能对同一个用户推送5次。只有改成系统push类型才能没有这个限制,参考:链接
4)设备显示阶段
(1)设备必须打开通知权限才能显示
比如oppo的通知权限默认是关闭的,需要打开通知权限,或者引导用户打开后才能显示。
(2)应用包名和注册oppo配置保持一致
应用的包名要和注册oppo平台填写的包名要一致,不然不会显示