uni-app如何配置App离线推送通道（华为/小米/OPPO）-uni-app-PHP中文网

离线推送收不到主因是厂商通道未通：华为需SHA256指纹与云打包证书一致、回执地址开启并填写正确；小米要求透传intent中component路径精确、Channel ID从新版控制台复制；OPPO须集成SDK、声明权限且应用状态为已上架；冷启动跳转需原生传参至plus.runtime.arguments，JS在onLaunch中解析。

uni-app如何配置app离线推送通道（华为/小米/oppo）

离线推送收不到，90%不是代码写错了，而是厂商通道根本没通——配置错一个参数，消息就静默丢弃。

华为通道：SHA256指纹和回执地址是两个致命点

华为后台校验不通过，根本不会报错，只会丢消息。关键不是App ID或Client Secret填错，而是：

SHA256证书指纹必须和你最终云打包用的签名证书完全一致——本地调试用debug.keystore，但DCloud云端打包用的是它生成的release证书，两者指纹不同，华为直接拒收
在AppGallery Connect开通Push Kit后，必须手动进入「应用回执状态」开关，并填写回调地址：https://thirdrcp-hz.getui.com/hw，缺这一步，华为认为你无法确认送达，后续所有离线消息都不下发
包名必须全小写、严格匹配manifest.json里的"name"字段，大小写不一致也会注册失败

小米通道：透传intent格式和component路径必须精确

小米只认透传消息（不是通知栏消息），且拉起App依赖intent字符串里的component字段。常见失效原因：

component格式必须为：你的包名/io.dcloud.PandoraEntry，少一个.、多一个空格、大小写错误（比如Pandoraentry）都会导致系统无法拉起App
小米Channel ID必须从「开放平台 → 应用服务 → 推送服务 → 应用配置」里复制，不能从旧版控制台或文档截图里抄
上传APK验证时，必须用和最终上线版本**完全一致的签名和包名**，否则通道认证通过但实际推送失败

OPPO通道：别漏掉OPPO Push SDK和权限声明

OPPO要求客户端显式集成SDK，且AndroidManifest.xml里必须声明特定权限，否则即使后台配对成功，设备也收不到离线消息：

Opposing Counsel

像对方律师那样审阅合同——寻找可施加影响的条款，而非追求公平性。当有人对你说“请以对方律师的角度来审阅这份文件”或“这份合同在谈判中会……”时使用。

下载

在manifest.json的"distribute" → "android" → "permissions"中，必须添加：""
OPPO Push SDK需通过HBuilderX插件市场安装uni-push-oppo，不能只靠UniPush 2.0自动注入
OPPO开发者平台中，应用状态必须是「已上架」或「已审核通过」，草稿状态不支持离线推送

离线点击跳转：JS监听器不生效，得靠原生参数传递

App被杀后，plus.push.addEventListener("click", ...)根本不会执行——因为JS环境还没启动。跳转逻辑必须由原生层完成：

厂商通道下发时，必须把目标页面路径（如/pages/msg/detail）作为自定义参数（payload或ext字段）传入
App冷启动时，DCloud底层会把该参数塞进plus.runtime.arguments，JS侧需在onLaunch里读取并uni.navigateTo

示例：

export default {
  onLaunch() {
    const args = plus.runtime.arguments;
    if (args && args.indexOf('page=') > -1) {
      const page = args.split('page=')[1].split('&')[0];
      uni.navigateTo({ url: page });
    }
  }
}

最常被忽略的其实是签名一致性——华为/小米/OPPO三端用的必须是同一套签名证书，否则设备识别为不同应用，厂商通道各自独立注册，离线消息就断在第一步。