服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 变化适用于发往 EventBridge 的现有订阅以及各受支持的 API 版本。
- 按原始 UTF-8 字节数判断内联边界,Shopify 这里的 1 MB 为 1,000,000 字节。
- 传统 webhook 超限时先按 ID 补取必要字段,Events 超限时按到期时间下载完整消息。
- AWS 目标服务的输入配额要单独验证。
已有订阅需要改配置吗
Shopify 公告说明,新上限自动适用于现有 Amazon EventBridge 订阅,包括通过 shopify.app.toml 或 GraphQL Admin API 配置的订阅。仅为获得新的上限,无需重建订阅。此前超过 256 KB 可能进入回退的商品或订单消息,现在有一部分会带完整正文直接送到 EventBridge。
Shopify 计算的是原始 UTF-8 负载字节数,内联上限包含 1,000,000 字节。字符数量可能与字节数不同,JSON 序列化的内容也会改变大小。排查时应分别记录 Shopify 负载、EventBridge 封装和目标服务收到的输入大小,便于定位哪一层超限。
传统 webhook 和 Events 怎样分别处理
传统 webhook 超过上限时仍只给资源 ID。接收端应依据订阅主题与实际消息结构区分这类精简消息,需要额外字段时再用有权访问的 Admin API 查询该资源。后续查询读到的是查询时的资源状态,不能把它当作原始事件发生时的完整快照。
新版 Events 超过上限会送来带 payload_url、payload_size_bytes 和 expires_at 的较小消息。先检查是否有 payload_url,再访问内联正文中通常使用的字段。发现下载链接时,在到期前取得完整内容。Shopify 将它视为短期凭据,处理时不要把完整链接写入日志。
EventBridge 接到了消息,为什么下游仍可能失败
Shopify 的 1,000,000 字节是发送方的内联负载上限,为 EventBridge 的 1 MiB 条目限制留出封装空间。消息进入事件总线后,还会由规则路由给具体目标。下游服务、目标类型、输入封装以及接收程序自己的大小限制,仍可能使一条已进入 EventBridge 的消息无法处理。
先在测试环境核对当前目标的输入配额和实际接收结果。若目标只需要订单 ID、事件类型和少量状态,可以考虑由 EventBridge 输入转换器传递必要字段。先确认转换后保留了消费者需要的路由信息,也能继续识别两种超限消息;转换器不会替订阅提高 Shopify 的内联上限。
上线前核对四种消息形态
用合成测试数据覆盖小消息、旧 256 KB 上限以上且低于新上限的完整正文、传统 webhook 的仅 ID 消息,以及带临时链接的 Events 消息。按 UTF-8 测量字节数,核对解析器、队列或目标服务实际接收到的内容,以及重复传递时的处理结果。
如果应用只需要少数资源字段,可评估传统 webhook 的 include_fields 或新版 Events 订阅的 query 选择。调整前先列出消费者确实读取的字段,测试是否仍能区分内联与回退,并观察补取次数和目标交付错误。
资料来源
常见问题
订单商品行很多时,还需要补查 Admin API 吗?
先检查传统 webhook 有没有直接带齐消费者需要的字段。如果收到只含资源 ID 的超限消息,才根据业务需要补查。Events 的超限消息则按临时链接取完整正文。
Shopify 的 1 MB 可以理解为 1,048,576 字节吗?
Shopify 公告把这个内联负载阈值定义为 1,000,000 字节。1 MiB 是 EventBridge 条目的另一个限制,还需给事件封装留空间。
这个新上限也适用于直接发往 HTTPS 的订阅吗?
这次公告明确针对 Amazon EventBridge。其他投递通道应分别查对应的 Shopify 文档。