[原创]【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit-HarmonyOS-看雪安全社区

#### 1.问题描述：

消息推送未接收到可以缓存多久？

#### 解决方案：

"Push Kit接收方无法收到消息分两种情况：

1、如果接收端的设备离线，导致消息重新发送到接收端设备，则应用消息最多可以在Push Kit服务器侧缓存15天，该缓存时间可以在pushOptions中由ttl参数定义。

2、如果接收端设备在线，但是应用不在前台，导致推送后台消息时无法推送至应用，则该消息会缓存至端侧，最多可缓存7天。"

#### 2.问题描述：

消息推送图片不展示。

#### 解决方案：

"对于请求体中image字段有如下限制：

1、image字段支持图片格式为PNG、JPG、JPEG、BMP，图片长*宽建议小于128x128像素，若超过49152像素，则图片不展示。
2、Wearable不支持右侧大图标样式。
3、如果图片地址无法下载也不会展示，请确认图片链接有效。"

#### 3.问题描述：

无法收到消息推送。

#### 解决方案：

"可以根据如下步骤排查问题：
* 当收到资讯营销类消息时，由于静默通知仅在通知中心展示，并不会弹框提示，需要去通知中心查看。通知中心如下图，可以查看对应消息。
* 若终端上的app手动关闭了消息提醒方式，终端收到消息不会有提醒，需要打开所需的提醒方式。
* 打开<a href="elink@c6bK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3M7$3g2J5N6X3W2U0k6g2)9J5c8X3A6G2M7%4m8Q4x3V1k6S2k6$3y4Q4x3V1k6A6L8X3c8W2P5q4)9J5k6h3S2@1L8h3I4Q4x3U0y4Q4x3V1j5`.">AGC平台</a>，按查询路径：“开发与服务&gt;增长&gt;推送服务&gt;自助分析（Beta）”，在自助分析里面输入requestId和token，系统会自动分析消息推送失败的原因，注意requestId有效期为三天。
  Push token不是有效的token，建议您在应用启动时调用getToken()接口，若设备的Push Token发生变化，及时上报到您的应用服务器更新Push Token，以防由于Push Token失效导致收不到消息。
* 检查服务端发送请求时是否正确携带Authorization请求头，value为JWT格式字符串，是基于服务账号生成鉴权令牌。可参考：<a href="elink@d2bK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1M7X3g2X3k6i4u0W2L8X3y4W2M7#2)9J5c8Y4m8#2M7$3S2Q4x3X3c8K6j5$3g2F1j5i4u0A6L8%4A6W2k6q4)9J5k6r3q4H3K9g2)9J5k6s2u0W2M7i4g2W2M7%4c8Q4x3X3c8K6N6s2u0#2j5%4b7`.">请求体结构说明</a>。
* <a href="elink@359K9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1k6%4g2A6k6r3g2K6i4K6u0r3M7s2g2K6K9q4)9J5k6r3u0S2j5$3E0Y4M7X3!0#2L8X3b7`.">推送后台消息</a>用于内容不频繁更新的场景，不会显示通知、播放铃声或改变应用角标。终端设备接收到后台消息后，如果应用进程在前台则将消息内容传给应用；如果应用进程不在前台则缓存消息，等待应用启动后再传给应用。
* 如果设备离线，Push Kit会缓存消息，待设备上线后，再将消息推送给设备。
* 检查自分类权益是否已申请，并且打开自分类权益开关，请参考：<a href="elink@12eK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1k6%4g2A6k6r3g2K6i4K6u0r3M7s2g2K6K9q4)9J5k6r3q4H3M7r3I4&6i4K6u0V1M7X3W2Y4K9s2b7`.">申请推送场景化消息权益</a>。
* 检查是否受到消息频控。
  
  * 调测阶段：每个项目每个自然日最多可推送1000条测试消息（非设备级，所有设备共用1000条），且不受场景化消息频控限制（即不区分通知消息类别、不区分场景化消息类别）。可以在消息发送请求体中设置<a href="elink@288K9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1M7X3g2X3k6i4u0W2L8X3y4W2M7#2)9J5c8Y4m8#2M7$3S2Q4x3X3c8K6j5$3g2F1j5i4u0A6L8%4A6W2k6q4)9J5k6r3q4H3K9g2)9J5k6s2u0W2M7i4g2W2M7%4c8Q4x3X3c8H3j5i4u0S2L8g2)9J5x3%4y4W2j5%4c8A6L8$3^5@1x3e0R3K6x3U0p5H3x3e0p5J5x3e0t1`.">pushOptions.testMessage</a>为true，发送测试消息。
  * 正式发布阶段：单设备单应用下每个自然日最多可推送3000条消息，并受<a href="elink@f7aK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1M7X3g2X3k6i4u0W2L8X3y4W2M7#2)9J5c8Y4m8#2M7$3S2Q4x3X3c8E0M7$3N6Q4x3X3c8X3M7X3g2I4i4K6u0V1j5$3!0F1N6s2u0G2L8q4)9J5x3%4y4W2j5%4c8A6L8$3^5#2y4e0p5^5z5o6t1^5x3U0l9K6y4U0R3`.">场景化消息频控</a>限制。
* 参考<a href="elink@9bdK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1k6%4g2A6k6r3g2K6i4K6u0r3M7s2g2K6K9q4)9J5k6s2y4W2L8X3c8Q4x3X3c8S2L8r3g2J5N6q4)9J5x3%4y4W2j5%4c8A6L8$3^5$3z5e0M7#2x3e0V1J5x3e0V1I4x3K6j5`.">推送消息跳转能力</a>文档，检查module.json5中skills配置是否正确。
  
  * 应用只需要配置一条skill对象。
    
    * 设置action参数点击消息进入应用页面（若skills中添加了uris参数，则**uris内容需为空**）
  
    * 设置uris参数点击消息进入应用页面（skills中必须同时设置actions参数，**actions参数需为空**）
  
  * 应用需要配置多条skill对象。
    比如同时设置推送消息跳转能力和其他跳转能力（如NFC跳转、浏览器跳转等），可以在skills数组中创建不同的skill对象，分别映射对应的能力。"

传递专业知识、拓宽行业人脉——看雪讲师团队等你加入！！

最新回复 (1)
mb_eekvgidg 雪币： 249 活跃值： (175) 能力值： ( LV2，RANK：10 ) 在线值：发帖 0 回帖 28 粉丝 0 关注私信	mb_eekvgidg 2 楼很有内涵，能联系我吗137334010（企鹅 2026-4-7 21:19 0
	游客登录 \| 注册方可回帖回帖表情雪币赚取及消费高级回复