HarmonyOS 鸿蒙Next中Push Kit在推送时有什么限制？

HarmonyOS 鸿蒙Next中Push Kit在推送时有什么限制？ 我们要使用push kit来实现消息推送，这个使用起来有啥限制没有

5 回复

HarmonyOS 5 Push Kit 推送限制

核心限制速览

限制类型 具体规则 超限后果
消息体大小 不超过 4096 Bytes（不含 Token） 消息被丢弃
单次推送 Token 数 最多 1000 个 / 次 报错 80300010，需分批
测试消息 每项目每日 1000 条（全应用共享） 报错 256，次日恢复
单设备单应用 每日总推送≤3000 条 报错 102，次日恢复
场景化频控 卡片刷新：已上架 2 条 / 天 / 卡，未上架 5 条 / 天 / 卡；实况窗：5 分钟≤10 次、1 小时≤60 次（赛事 / 打车 5 分钟≤30 次、1 小时≤180 次） 报错 256
推送速率 QPS 按 MAU 与类型分配，不足 6000 按 6000 算 报错 503
网络要求 需放通 443/5223 端口，IP 不可白名单 送达率下降
夜间管控 0:00–6:00 非活跃设备缓存消息（VoIP 除外） 非即时送达

关键说明

  1. 送达率影响因素：设备离线（缓存上线补发）、卸载、网络不稳、安全策略会降低送达。
  2. 消息分类：未开通自分类权益时，通知消息默认归资讯营销类，单设备每日限 2 条；开通后可分服务与通讯类（无单独上限，受总配额约束）。
  3. 回执码：超限分别返回 102/256/503/80300010，可通过回执服务排查。

官方文档

更多关于HarmonyOS 鸿蒙Next中Push Kit在推送时有什么限制？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


华为 Push Kit 推送的核心限制如下：

  1. 送达与时效： 设备离线、应用卸载、网络不稳、设备安全策略会影响送达；离线消息会缓存，设备上线后补发。用户睡眠期间系统会管控消息（应用内通话 / VoIP 除外），苏醒后再投递。
  2. 消息规格： 单条消息体最大4096Bytes（不含 Push Token）；测试消息全项目共享1000 条 / 天，正式消息按场景有频控配额。
  3. 网络要求： 需放通5223、443端口；推送服务器 IP 动态分配，无法通过 IP 白名单放行，受限网络会降低送达率Huawei Developer。
  4. 地域与设备： 除可穿戴设备外，其余设备仅支持中国境内（港澳台除外）；支持手机 / 平板 / PC 等多设备，但不支持云真机调试，模拟器与真机存在能力差异。
  5. 其他约束： 应用通知默认关闭，推送前需先获取用户授权；卡片刷新、实况窗、应用内通话等消息，需搭配对应 Kit 提前创建相关能力。

详情可见：【Push Kit约束和限制】

Push kit 约束与限制

影响送达率的因素说明

Push Kit致力于提供安全可靠的系统级消息发送通道，保障消息成功送达。影响消息送达率的因素如下：

  • 终端设备是否在线。如果设备离线，Push Kit会缓存消息，待设备上线后，再将消息推送给设备。
  • 终端设备上应用是否被卸载。
  • 终端设备的网络状况是否稳定。
  • 终端设备的安全控制策略。

推送消息的及时性

在终端设备网络条件良好且不拥堵情况下，Push Kit将使用智能推送策略以减少推送消息的时延。

说明

为降低对用户的打扰，系统会学习用户的行为习惯，预测用户的睡眠时间，在用户睡眠期间实施消息管控。在此期间推送服务将暂时缓存该时间段内收到的消息（应用内通话或category=VoIP的消息除外）。用户结束睡眠后，推送服务会将消息重新投递到对应设备。

推送消息长度与数量限制

  • 消息体最大不能超过4096Bytes（不包括Token），若超过请求会返回错误码80300008。
  • 每个项目每日全网最多可推送1000条测试消息，正式消息区分场景有不同的配额，参考消息频控说明。

网络受限说明

如果终端设备连接的网络配置了防火墙或处于受限的网络下，将会影响消息的送达率，请检查以下端口号是否被禁用。

端口号：

  • 5223
  • 443

说明

终端设备连接的推送服务器的IP是动态分配的，无法通过配置IP白名单方式放行。建议连接不受限的网络或放通以上端口。

支持的设备

推送服务能力支持Phone、Tablet、PC/2in1、Wearable、TV设备。

云真机说明

Push Kit不支持云真机调试。

模拟器支持情况

Push Kit支持模拟器，但与真机存在部分能力差异，具体差异如下。

  • 通用差异：请参见“模拟器与真机的差异”。
  • 模拟器不支持推送语音播报消息、推送实况窗消息、推送应用内通话消息

HarmonyOS 鸿蒙Next中Push Kit推送限制包括：单设备每日推送频次上限（默认约1000条），单条消息负载大小≤4KB；需用户授权通知权限；仅支持应用前台或后台运行时有通知栏权限；静默消息（无通知栏展示）需申请特殊权限；不支持自定义推送通道优先级。

Push Kit在HarmonyOS Next中有以下主要限制：

消息类型与展示：通知消息会直接展示在通知栏，受系统通知样式限制；透传消息仅当应用存活（前台或后台）时由应用自行处理，进程被清理后无法送达。

频控与额度：每日推送总量有上限，不同应用类别和权益档位对应不同的单设备及全量推送频次，超限会被拒绝。

消息有效期：离线消息最大存储时间通常为72小时，超期未送达即丢弃。单条消息体大小一般不超过4KB。

推送目标：支持按Token、标签、主题等精准推送，标签和主题存在数量上限；单设备通知栏常驻消息条数也受系统控制。

权限与鉴权：必须获取推送通知的用户授权，且需正确配置AppGallery Connect中的推送权益与OAuth凭证；部分场景还依赖应用自启动权限。

以上限制决定了消息时效、体量和到达条件，集成时需据此设计消息策略。

回到顶部