离线推送收不到是因厂商通道未通而非代码错误；需确保SHA256指纹一致、华为开启应用回执、小米intent组件严格匹配、vivo/荣耀满足版本要求，且所有配置必须云打包生效。
plus.push 的 JS 事件监听不到离线推送 —— 这不是代码写错了，是系统限制。离线消息必须走厂商通道拉起 App，JS 层只能在原生回调触发后才开始工作。
离线推送收不到？先查厂商通道是否真正通了
90% 的“收不到”问题出在厂商配置，而非代码逻辑：
- SHA256 证书指纹必须和云打包用的签名证书完全一致（debug.keystore 和 release 签名不通用）
- 华为需在 AppGallery Connect 中手动开启「应用回执状态」并填写回调地址 https://thirdrcp-hz.getui.com/hw
- 小米透传 intent 的 component 必须严格匹配包名 + 启动 Activity，例如 com.yourapp/io.dcloud.PandoraEntry，大小写、点号缺一不可
- vivo/荣耀要求 HBuilderX ≥ 4.36 且 TencentCloud-Push ≥ 1.1.0，否则 manifestPlaceholders.json 和 mcs-services.json 不生效
- 所有配置修改后必须重新云打包，**基座调试无法验证离线能力**
nativeResources 目录结构和关键文件放哪
配置文件必须放在与 uni_modules 平级的 nativeResources 目录下，否则编译时不会被打入 APK：
- 新建 nativeResources/android/assets 目录
- 下载 timpush-configs.json（从腾讯云 Push 控制台「厂商配置」页下载），放入 nativeResources/android/assets/
- google-services.json 放在 nativeResources/android/ 根下（仅 FCM 场景需要）
- 若项目无 nativeResources 目录，请手动创建，HBuilderX 不会自动补全
点击通知跳转页面的唯一可靠入口是 click 事件
onLaunch 和 onShow 在离线点击场景下基本失效：
- Android 的 options 在 onLaunch 中永远为空
- iOS 热启动时 onLaunch 不带任何推送字段
- 正确做法是在 App.vue 的 onLaunch 里立即注册：plus.push.addEventListener('click', (msg) => { const payload = msg.payload ? (typeof msg.payload === 'string' ? JSON.parse(msg.payload) : msg.payload) : {}; setTimeout(() => { uni.navigateTo({ url: payload.page || 'pages/index' }); }, 300); });
- 注意：跳转前加 setTimeout 是为了避开 Vue 实例未挂载导致的白屏；payload.page 路径不能带 .vue 后缀，也不能以 / 开头
角标（badge）显示失败的三个硬性条件
Android 角标不是 JS 设置个数字就行，它依赖三者同时满足：
- badgeClass 必须是 manifest 中带 LAUNCHER 的 Activity 完整类名（如 com.yourapp.MainActivity），反编译 APK 查最准
- 华为设备还需在 AndroidManifest.xml 的 application 节点里声明元数据：<meta-data android:name="com.huawei.hms.push.ENABLE_BADGE" android:value="true"/>
- 权限 android.permission.CHANGE_BADGE 必须在 manifest.json 中声明，并在运行时调用 plus.android.requestPermissions 申请
离线推送的复杂点不在 JS 层，而在原生集成深度和厂商平台细节的一致性。哪怕一个字母填错、一个文件放错目录、一次没云打包，都会导致整个链路静默失败 —— 它不像 HTTP 请求那样有明确报错，而是直接“没反应”。
