厂商 push 不通排查指南

简介： MPS 集成多个三方渠道，保障 push 使命必达的必须知道的几件事。

为了提升「MPS 消息推送」的推送的到达率，mPaaS 集成了华为、小米等厂商的推送功能，从而有效地提高用户留存率，提升用户体验。在日常运维过程中，发现少部分设备在厂商 push下无法 push，在此分享下相关案例的排查过程，方便后续同类问题借鉴。

一、push 相关背景

1.push 整体架构

以接触最多的国内 Android 设备为例，整体结构如下：

2.厂商 push 和自建 push

厂商 push 通道：优点是通过各个 OS 厂商维护的长链接进行推送，在 App 被系统杀掉后也可以进行推送，推送到达率高于自建push。支持华为，小米，oppo，vivo等厂商。缺点是，目前厂商的push基本都只支持通知栏消息的推送，在用户点击通知前，不启动应用，对红点, 图片等消息格式支持有限。

自建push通道：通过App启动后和自建服务端的长连接通道实现推送，缺点也很明显，App被杀掉后，就无法收到信息。主要用于不支持厂商渠道场景下的push。

二、问题排查举例

通过上面的介绍，可以看出三方厂商 push 是否成功，主要取决于三个链路，分别为：

三方 token 正确生成上报
服务端正常转发到厂商服务器
下发到客户端消息可以正常显示

1.测试准备

为了快速验证问题，我们需要准备一个推送程序，可以快速推送信息到App上。MPS提供了推送的Http接口供外部调用，我们可以通过初始化一个简单的java程序实现推送信息的发送，方便联调。使用链接

2.三方 token 生成阶段

目前 mPaaS 对三方厂商 push 的 token 生成分为以下步骤。

2.1 设备在三方push的厂商列表里

以华为设备为例，判断是否是华为设备的标准是，检测当前手机是否是 emui，如果是才走华为 PUSH SDK。在我们日常运维的 case 中，发现过部分设备由于刷机或者其他操作，在华为手机上安装的不是 emui，类似这种设备是走不了华为 push 的，只能走自建 push。

以vivo设备为例，低版本手机只有在vivo公布的白名单设备内才支持推送。

2.2 生成三方 token

在调用 push sdk 生成 token 的过程中，由于 push sdk 的生成也依赖当前手机的 room 版本，以华为为例，就强依赖华为手机内置的 HMS Core 版本。针对这种场景下的问题，在获取三方 token 失败的时候，会在回调里返回对应错误码。如下图所示，搜索 push 的关键字 mPush14，然后过滤，可以获取 token 返回错误码2。

我们查看华为定义的错误码，发现2表示 SERVICE_VERSION_UPDATE_REQUIRED，需要升级当前的 HMS 版本。

升级HMS版本的方案有两个

方案1：主动升级,调用更新服务接口,升级更新效果如下所示：

在启动阶段调用如下服务，安装更新华为推送服务
if (HuaweiApiAvailability.getInstance().isHuaweiMobileNoticeAvailable(context) == ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED) {// 需要升级HuaweiApiAvailability.getInstance().resolveError(activity, ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED, 1);
}