HarmonyOS 鸿蒙Next 如何定位调用推送接口返回正常，但是在手机侧收不到推送消息的问题 鸿蒙场景化案例

发布于 1周前 作者 bupafengyu 最后一次编辑是 5天前 来自 鸿蒙OS

HarmonyOS 鸿蒙Next 如何定位调用推送接口返回正常，但是在手机侧收不到推送消息的问题 鸿蒙场景化案例

【问题现象】

推送功能正常开启，app的推送权限也正常开启，token可以正常拿到，调用推送接口也返回正常，但是在手机侧收不到推送消息

【背景知识】

消息推送参考文档

【解决方案】

1、检查push token是否正确

打开AGC平台，选择我的项目，然后选择推送服务，在自主分析里面，输入requestId和token， 系统会自动分析消息推送失败的可能原因。

2、如涉及自分益权限，检查自分益权益是否已申请，并且打开自分益开关

涉及自分益权限 参考文档

3、 是否受到消息频控。

可以在消息发送请求体， 设置pushOptions.testMessage为true，发送测试消息。测试消息的限制为每天条。

4、配置文件配置错误

每个skill对象只能包含一种跳转能力，skill对象配置中只能包含entities和uris其中之一。

代码示例如下：

"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}, // 保证该skill对象中无uris配置
{
"actions": [
"com.app.action"
],
"uris": [
{
"scheme": "https",
"host": "www.app.com",
"port": "8080",
"path": "app/test"
}
] // 新增一个skill对象，配置actions和uris用于其他业务场景
Harmonyos Next教程
1 回复

针对HarmonyOS 鸿蒙Next调用推送接口返回正常，但在手机侧收不到推送消息的问题，以下是一些定位方法：

  1. 检查消息体字段：

    • 确认validate_only字段是否为false，否则消息仅做格式校验，不会推送至用户设备。
    • 检查是否包含message.notification和message.android.notification字段，否则消息可能作为透传消息处理，不会在通知栏展示。
    • 验证foreground_show字段设置，确保前台应用时也能正常显示通知。

  2. 使用Push自助分析：

    • 登录AppGallery Connect，通过“增长>推送服务>自助分析”查询消息发送情况。
    • 输入发送消息时的token和推送服务返回的requestId进行查询。

  3. 检查设备与应用设置：

    • 确保设备ROM版本为4.1及以上，某些推送消息类型需要此版本及以上的设备才能正确接收。
    • 验证应用通知权限和系统通知设置，确保应用已开启通知权限。
    • 检查Token有效性及消息分类配置。

  4. 其他排查方向：

    • 尝试重启设备，清除可能的临时故障。
    • 验证是否受到消息频控限制。

如果问题依旧没法解决请联系官网客服，官网地址是：https://www.itying.com/category-93-b0.html。

回到顶部