告别推送焦虑：手把手教你用uni-push 2.0搞定App在线/离线消息（附荣耀证书配置避坑指南）

每次看到用户反馈"为什么收不到通知"，作为开发者的你是否感到头皮发麻？消息推送这个看似简单的功能，在实际落地时却暗藏无数坑点。本文将带你用uni-push 2.0彻底解决这个痛点，特别针对荣耀机型的证书配置提供完整避坑方案。

1. 为什么你的推送总在"薛定谔状态"？

消息推送的不可靠性主要源于安卓生态的碎片化。当应用在前台时，我们使用在线推送（通过个推通道）；当应用退到后台或被杀死时，则需要依赖厂商通道进行离线推送。这种双通道机制本身就增加了复杂度。

更棘手的是，不同厂商对推送服务的实现各不相同：

• 华为/荣耀：需要申请推送服务并配置证书
• 小米/OPPO/VIVO：要求应用必须上架对应应用商店
• 其他安卓设备：依赖个推的自建通道

提示：测试阶段最容易忽略的是厂商通道的测试模式限制。例如华为每日仅允许500条测试消息，超过后将静默失败。

2. 从零搭建uni-push 2.0环境

2.1 服务开通与基础配置

首先在DCloud开发者中心完成以下准备工作：

1. 创建应用并开通uni-push 2.0服务
2. 关联阿里云免费版云服务空间
3. 在manifest.json中启用push模块

关键配置项检查清单：

json复制// manifest.json片段示例
"push": {
  "unipush": {
    "enable": true,
    "vendor": {
      "honor": {
        "appid": "你的荣耀应用ID",
        "appkey": "你的荣耀应用Key"
      }
    }
  }
}

2.2 客户端初始化最佳实践

在App.vue中建议采用以下健壮性更强的CID获取方案：

javascript复制let retryCount = 0;
const MAX_RETRY = 3;

function fetchClientId() {
  plus.push.getClientInfoAsync(
    info => {
      if (info.clientid) {