从零到一：uni push2.0全链路配置与实战推送指南

1. 为什么需要uni push2.0？

消息推送是移动应用最基础也最重要的功能之一。想象一下，你正在开发一个外卖APP，用户下单后需要实时收到订单状态变更通知；或者是一个社交APP，用户需要及时收到好友消息提醒。这些场景都离不开稳定可靠的消息推送服务。

uni push2.0是DCloud推出的新一代推送服务，相比传统方案有几个明显优势：

1. 全链路支持：同时覆盖在线推送（用户APP在前台运行）和离线推送（APP在后台或关闭状态）
2. 厂商通道集成：自动对接华为、小米、OPPO等手机厂商的系统级推送通道，大幅提升送达率
3. 开发成本低：一套代码同时支持iOS和Android平台，省去了原生开发的适配工作
4. 云函数支持：可以直接在uniCloud中编写推送逻辑，无需自建服务器

我在实际项目中使用过多个推送方案，uni push2.0最大的感受就是配置简单、送达率高。特别是在安卓设备上，通过厂商通道的离线推送几乎能做到100%送达，这对电商类应用来说简直是刚需。

2. 前期准备工作

2.1 开通uniCloud服务

首先需要确保你的项目已经开通uniCloud服务。这里推荐使用阿里云版本，稳定性更好。具体操作：

1. 在HBuilderX中右键项目目录
2. 选择"创建uniCloud云开发环境"
3. 选择阿里云作为服务商
4. 等待环境初始化完成

如果项目已经创建过uniCloud环境，可以跳过这一步。我建议新手先在测试项目上练习，熟悉流程后再应用到正式项目。

2.2 生成推送证书

推送证书是保证消息安全送达的关键。iOS和Android的证书生成方式不同：

Android证书生成：

1. 访问DCloud官方文档获取SHA256指纹
2. 在各大应用市场开发者后台配置签名信息
3. 下载各厂商的配置文件

iOS证书生成：

1. 登录Apple开发者账号
2. 创建APNs证书
3. 导出.p12文件
4. 上传到uniPush控制台

这里有个常见坑点：Android证书需要对应应用签名的SHA256值，如果后期修改了签名文件，必须重新配置所有厂商通道。我就曾经因为更换签名导致推送失效，排查了半天才发现问题。

3. uni push2.0详细配置

3.1 控制台基础配置

登录uni-app开发者中心，找到uniPush 2.0配置页面：

1. 如果没有应用，需要先创建新应用
2. 为应用添加平台信息（iOS和Android需要分别配置）
3. 上传前面生成的证书文件
4. 配置应用包名和Bundle ID

特别注意：Android平台需要配置各厂商的离线推送参数。以华为为例：

• 应用ID：在华为开发者后台创建应用时分配
• 应用密钥：同上
• 回调地址：用于接收推送状态回执

配置完成后建议先保存，不要立即启用。等所有参数检查无误后再开启推送服务。

3.2 厂商通道特殊配置

厂商通道是提升安卓推送到达率的关键。各家配置略有不同：

小米通道：

• 需要申请推送权限
• 配置默认通知样式
• 设置消息分类

OPPO通道：

• 需要单独申请推送权限
• 有每日推送限额
• 必须配置通知图标

vivo通道：

• 需要上传签名文件
• 配置消息分类
• 设置测试设备

实测下来，华为和小米的通道稳定性最好，OPPO和vivo偶尔会有延迟。建议在代码中对不同厂商做兼容处理。

4. 编写推送云函数

4.1 创建云函数

在uniCloud/cloudfunctions目录下新建云函数：

1. 右键点击"新建云函数"
2. 勾选uni-cloud-push扩展库
3. 输入函数名称如"uni-push"

基础推送代码示例：

'use strict'; const uniPush = uniCloud.getPushManager({ appId:"__UNI__XXXXXX" // 替换为你的应用ID }) exports.main = async (event, context) => { const data = JSON.parse(event.body) return await uniPush.sendMessage({ "getui_alias": data.alias, // 使用别名推送 "title": data.title, "content": data.content, "force_notification": true, // 强制显示通知 "payload": data.payload // 自定义数据 }) }

这个示例实现了最基本的推送功能。实际项目中你可能需要添加：

• 错误处理逻辑
• 推送频率限制
• 用户标签支持
• A/B测试功能

4.2 部署和调用

编写完成后：

1. 右键云函数选择"上传部署"
2. 在uniCloud控制台找到该函数
3. 复制调用URL

调用示例：

uni.request({ url: '你的云函数URL', method: 'POST', data: { alias: 'user123', title: '订单通知', content: '您的订单已发货', payload: { orderId: '123456' } }, success(res) { console.log('推送成功', res) } })

5. 客户端消息处理

5.1 监听推送消息

在App.vue的onLaunch中添加消息监听：

onLaunch() { // #ifdef APP-PLUS const pushMessageCallback = (res) => { const { data } = res if (res.type === "receive") { // 前台收到消息 console.log('收到推送', data) } else { // 点击通知栏 uni.navigateTo({ url: `/pages/order/detail?id=${data.payload.orderId}` }) } } uni.onPushMessage(pushMessageCallback) // #endif }

5.2 安卓通知渠道配置

安卓8.0以上需要配置通知渠道：

// #ifdef APP-ANDROID const plugin = uni.requireNativePlugin("DCloud-PushSound") if (plugin) { plugin.setCustomPushChannel({ channelId: "order_channel", channelDesc: "订单通知", importance: 3 // 重要程度 }) } // #endif

不同重要程度会影响通知的显示方式：

• 1：最低，不发出声音
• 3：默认，发出声音但不弹出
• 4：高，弹出通知
• 5：最高，立即弹出

6. 调试与优化技巧

6.1 常见问题排查

推送不成功时，可以按照以下步骤排查：

1. 检查证书是否过期（特别是iOS）
2. 确认设备token是否有效
3. 查看厂商通道配置是否正确
4. 检查云函数日志是否有报错
5. 测试在线推送和离线推送

我常用的调试方法是先在控制台发送测试推送，确认基础功能正常后再进行业务集成。

6.2 性能优化建议

1. 合并推送：对同一用户的多个通知合并发送
2. 智能调度：根据用户活跃时间选择推送时段
3. A/B测试：对比不同文案的点击率
4. 标签管理：建立用户画像，实现精准推送
5. 频率控制：避免过度推送导致用户关闭通知

实际项目中，推送策略需要根据业务特点不断调整。比如电商APP大促期间可以适当增加推送频率，而工具类APP则要保持克制。