HarmonyOS NEXT 使用 Android 方案收不到推送，如何处理？
现象：在 HarmonyOS NEXT 设备上按 Android 接入方案收不到推送。
原因：HarmonyOS NEXT 上 Android 厂商通道不可用。
处理：
先区分设备与应用形态：HarmonyOS NEXT（纯血鸿蒙）还是 Android 兼容模式；鸿蒙原生应用还是 Android APK。
HarmonyOS NEXT 上 Android 厂商通道不可用，需按鸿蒙原生 Push 方案接入，参见 厂商配置 > HarmonyOS。
Android 兼容模式下运行 Android APK 时，沿用 Android 厂商通道方案。
HarmonyOS 推送报错 80300002，如何处理？
现象：错误码：80300002；错误信息：harmony requestid: xxxxx, msg: No permission to send message to these tmIDs。
原因：IM 控制台证书凭证未在正确项目下创建，或密钥文件中的 project_id 与应用在 AppGallery Connect 中的项目 ID 不一致。
处理：请自查 厂商配置 > 步骤3：创建 IM 控制台证书凭证，确保在正确项目下已创建证书凭证，或对比查看密钥文件中的 project_id 与应用在 AppGallery Connect 中的项目 ID 是否一致。
HarmonyOS 推送报错 1000900010，如何处理？
现象：报错 1000900010 Illegal application identity。
原因：常见为自动签名、包名不一致、Push Kit 开通后未重新申请 Profile、证书过期、client_id 写法不正确，或使用了云真机。
处理：请按概率从高到低逐项核对：
1. 签名方式：使用手动签名（
.p12 + .cer + .p7b），自动签名高发此问题。2. 包名一致：AppGallery Connect、IM 控制台鸿蒙证书、Profile、工程
bundleName 四方完全一致。3. Push Kit 开通后重新申请 Profile：旧 Profile 无法拿到合法 Push Token。
4. 证书有效期：签名证书过期会导致签名失败。
5. client_id：在
module.json5 的 metadata 中写死（不要使用 $string 引用）。6. 设备：云真机不支持，请使用本地真机验证。
HarmonyOS 开启 useNormalizedOHMUrl 后点击通知崩溃，如何处理？
现象：开启
useNormalizedOHMUrl 后，点击推送通知时应用崩溃。原因：可能是点击回调注册时机、控制台跳转配置、路由或 HAR 配置异常，也可能是旧版 SDK 的通知栏点击逻辑问题。
处理：
1. 将 HarmonyOS TIMPush SDK 升级到
8.7.7203 或更高版本；该版本已优化通知栏点击跳转逻辑，详情参见 HarmonyOS 更新日志。2. 在控制台将点击后续动作设置为打开应用内指定界面，并保留默认值。
3. 在
UIAbility.onCreate() 中注册 onNotificationClicked 回调，具体示例参见 HarmonyOS 快速接入。4. 如果仅在开启
useNormalizedOHMUrl 后崩溃，请暂时关闭该开关并收集崩溃堆栈，再 提交工单 定位兼容性问题。
