plus.push.addeventlistener("click")必须在app.vue的onlaunch中注册，否则冷启动时无法捕获离线推送点击事件；需做payload类型判断并缓存后跳转，避免直接调用uni.navigateto失败。
plus.push.addEventListener 必须在 onLaunch 里注册，否则收不到离线点击
离线推送（即 App 被杀掉或未启动时收到的通知）点击后拉起 App，事件不会走 onLaunch 或 onShow 的 options 参数，iOS 热启动、Android 全场景都为空。唯一稳定捕获的方式是原生 push 监听器 —— 且必须在 App.vue 的 onLaunch 中第一时间挂载，晚于 App 启动完成就错过事件。
常见错误：把监听写在某个页面的 onLoad 或 mounted 里，真机上完全不触发；或者只监听了 receive 没监听 click，导致点击无响应。
- 监听必须用
plus.push.addEventListener('click', callback)，不能省略第二个参数false - 不要在
onShow里重复注册，避免多次绑定同一回调 - 确保
#ifdef APP-PLUS包裹，防止 H5 或小程序编译报错
iOS 和 Android 的 msg.payload 结构不一致，解析前必须判断类型
服务端下发的透传 payload，在双端到达客户端后结构不同：iOS 的 msg.payload 是已解析的 Object，Android 的是字符串（需 JSON.parse()），部分厂商通道（如华为、小米）还会额外塞进 msg.intent 或 msg.extra。
直接 JSON.parse(msg.payload) 在 iOS 上会报错；直接取 msg.payload.id 在 Android 上会是 undefined。必须做类型兜底。
- 统一处理方式：
const payload = msg.payload ? (typeof msg.payload === 'string' ? JSON.parse(msg.payload) : msg.payload) : {} - 华为离线推送若配置了
/message/android/category，但服务端没匹配对应 category，消息可能静默丢弃 - vivo/OPPO 等厂商要求 App 上架后才开通离线通道，未上架时离线推送始终失败
点击后不能直接调用 uni.navigateTo，要等 Vue 实例 ready
在 plus.push 回调里立即执行 uni.navigateTo({ url: '/pages/detail?id=123' }) 会失败，因为此时 App 还没完成初始化，uni 的路由系统尚未就绪，控制台通常报 Cannot read property 'navigateTo' of undefined 或白屏。
这不是 bug，而是生命周期顺序问题：原生事件早于 Vue 实例挂载。
- 推荐做法：用
uni.setStorageSync('push_payload', payload)缓存数据，然后在首页onLoad或onShow中读取并跳转，跳完再uni.removeStorageSync('push_payload')清除 - 避免在首页重复跳转：加个标记位或检查
payload是否已处理过 - 不要用
setTimeout等“时机”，不可靠；nextTick也无效，因为不是 Vue 生命周期事件
离线推送依赖厂商通道，配置漏一项就全平台失效
UniPush 的离线能力本质是调用各厂商 SDK（华为 HMS、小米 MiPush 等），不是 uni-app 自己实现的。只要任一环节断开，离线消息就无法到达 —— 即使在线推送完全正常。
最容易被忽略的是证书和签名一致性：DCloud 打包用的 keystore、厂商平台上传的 SHA256 签名、App 包名，三者必须严格一致，差一个字符都会导致华为收不到、小米显示“未开启推送”。
- HBuilderX 打包时必须勾选「使用自定义 keystore」，且与华为/小米后台填的签名完全一致
- 华为需在 AppGallery Connect 开通 Push 服务，并在 DCloud 后台填写正确的
client_id和client_secret - 小米需在 MiPush 后台开启「应用内消息」权限，否则离线点击后无法唤醒 App
离线推送不是“写完代码就能跑”，它卡在操作系统层和厂商服务之间，任何一环配置偏差都会静默失败，而且没有明确报错。真机测试阶段务必用不同品牌手机交叉验证，别只盯着一台华为测。
