【报Bug】uni-push 2.0 HarmonyOS通过uniCloud sendMessage推送无法锁屏到达

一、问题概述

uni-push 2.0 在 HarmonyOS NEXT 正式签名 App 中，通过 DCloud uni-push 控制台向指定 CID 发送“通知消息”时，App 在后台锁屏状态可以立即显示系统通知。

但是，通过支付宝云 uniCloud 云对象调用 uniCloud.getPushManager().sendMessage() 向相同 CID 推送时，云端接口返回成功，HarmonyOS 后台锁屏状态却不显示通知；只有重新打开 App 后，消息才到达并显示。

该问题可以稳定复现。

二、开发及运行环境

• AppID：__UNI__CFD7258
• 项目名称：monthly-close-app-v2
• uni-push版本：uni-push 2.0
• 云服务商：支付宝小程序云
• PC操作系统：Windows 10
• PC操作系统版本：10.0.19044.7663
• HBuilderX版本：5.24 正式版
• 项目创建方式：HBuilderX
• 客户端平台：HarmonyOS NEXT
• HarmonyOS版本：HarmonyOS 6.0.0
• 手机厂商：华为
• 手机型号：HUAWEI Pura X
• 前端框架：Vue3
• 页面类型：vue
• 打包方式：云端打包
• 安装包类型：正式签名包，非运行基座
• CID：6903ee2450d0****7303382d8e41（公开内容已脱敏，完整CID可向管理员提供）

三、前置条件

1. HarmonyOS正式签名App已经集成并开通uni-push 2.0。
2. App可以正常取得CID并完成用户与设备绑定。
3. 手机已经开启App通知权限。
4. 锁屏通知、横幅通知和桌面角标均已开启。
5. 静默通知已经关闭。
6. 手机“休眠时始终保持网络连接”已经开启。
7. App通过Home键退至后台，没有从最近任务中上划关闭，也没有被强行停止。
8. 手机网络连接正常。

四、复现步骤

1. 在HUAWEI Pura X手机中安装并启动正式签名App。
2. 登录用户账号，并确认App成功获取CID。
3. 将App通过Home键退至后台并锁屏。
4. 在DCloud uni-push控制台，向该CID发送“通知消息”。
5. 手机在后台锁屏状态可以立即收到并显示该系统通知。
6. 改用支付宝云uniCloud云对象，通过 uniCloud.getPushManager({ appId }).sendMessage() 向相同CID发送相同类型的通知。
7. 云端返回 errCode=0、errMsg=success。
8. App后台锁屏状态没有显示系统通知。
9. 等待数分钟后仍然没有锁屏通知。
10. 重新打开App后，刚才通过云对象发送的消息才到达并显示。
11. 多次重复测试，现象一致。

五、最小复现代码

const push = uniCloud.getPushManager({  
  appId: '__UNI__CFD7258'  
})  

const result = await push.sendMessage({  
  push_clientid: '已脱敏CID',  
  title: '待审批任务提醒',  
  content: '任务提交后已超过5分钟，请及时审批。',  
  force_notification: true  
})  

console.log(result)

六、已经测试的参数组合

以下参数组合均已测试。云端均返回成功，但HarmonyOS后台锁屏状态均不展示通知：

1. push_clientid + title + content + payload + force_notification + badge + options
2. push_clientid + title + content + payload + force_notification
3. push_clientid + title + content + force_notification

其中已经分别测试：

• 保留及删除 payload
• 保留及删除 badge
• 保留及删除 options
• 保留 force_notification: true
• 对 push_clientid 执行 String(...).trim()

以上调整均未解决锁屏通知无法到达的问题。

七、云端执行结果

uniCloud定时云对象能够正常执行，业务通知记录也能够正常写入数据库。

日志统计如下：

notificationCreated=1  
reminded=1  
noDevice=0  
noPushConfig=0  
failed=0

sendMessage()返回：

errCode=0  
errMsg=success

这说明uni-push平台已经受理请求，但无法确认HarmonyOS厂商离线通道是否真正接收并展示该通知。

八、实际结果

1. DCloud uni-push控制台向该CID发送通知消息时，HarmonyOS后台锁屏可以立即显示系统通知。
2. uniCloud云对象调用 getPushManager().sendMessage() 时，接口返回成功，但后台锁屏不显示通知。
3. 只有重新打开App后，消息才到达并显示。
4. 云端没有返回HarmonyOS厂商通道失败原因。

九、预期结果

uniCloud云对象调用 getPushManager().sendMessage() 返回成功后，应当与DCloud uni-push控制台发送“通知消息”的效果一致：

• App处于后台时可以显示系统通知；
• 手机锁屏时可以立即显示锁屏通知；
• 不需要用户重新打开App才能收到消息。

十、请求协助

请协助：

1. 查询该CID在测试时间对应的HarmonyOS厂商Device Token是否正常。
2. 查询HarmonyOS厂商推送通道的实际下发结果和返回错误码。
3. 确认支付宝云是否支持通过 uniCloud.getPushManager().sendMessage() 向HarmonyOS发送厂商离线通知。
4. 提供HarmonyOS厂商离线“通知消息”的正确 sendMessage() 参数格式。
5. 说明为什么DCloud控制台通知可以锁屏到达，而uniCloud云对象向同一CID推送只能在重新打开App后到达。

完整CID、准确测试时间、uniCloud RequestID及相关日志可以在仅管理员可见区域提供。