目次
Shopifyの11月17日付の公式変更履歴で、Amazon EventBridge経由のとEventsの本文上限が256 KBから1 MBへ拡張されました。1 MBは1,000,000バイトです。全バージョンへ自動適用され、既存の購読を更新する必要はありません。商品や注文をへ連携するアプリでは、これまでIDやダウンロード用URLだけ届いたデータが、本文を含む形で届く範囲が広がります。 Shopifyの上限拡張の発表
対象チームが先に行いたいのは、API版の更新より、EventBridgeの先にある受信処理の点検です。本稿は2026年11月19日時点の公式資料を基にした実践解説です。実環境での性能測定結果ではなく、コードと検証項目は説明例・提案として示します。既存のを残しながら、大きい本文を最後まで処理できるかを確かめます。
スポンサーリンク
本文が届く範囲が広がってもフォールバックを削除しない
従来、上限を超えたclassic webhookはIDだけの本文になり、アプリがAdmin APIからリソースを取得する必要がありました。Eventsは本文の代わりに取得先を渡す方式でした。今回の変更後も1,000,000バイトを超えると、classic webhookはIDのみ、Eventsはpayload_urlなどを含む小さな本文になる挙動が続きます。
そのため、リソースの取得処理が不要になったと一括で削除しないでください。変化するのは、インラインで届く範囲です。入力を受ける部分では配信方式を識別し、完全な本文がある場合とフォールバックの場合を別の経路に分けます。同じ注文でも明細の数などで大きさが変わるため、一件の成功だけで分岐が不要とは判断できません。
Eventsはdataを読む前にpayload_urlを確認する
ShopifyのEvents配信構造では、オーバーフロー時の小さな本文にtopic、action、handle、payload_url、payload_size_bytes、expires_atが入り、fields_changed、query_variables、dataは取得先の完全な本文に含まれると説明しています。先にdataへアクセスする実装では、正常なフォールバックを不正入力として扱う可能性があります。
URLがある場合は有効期限内に完全な本文を取得し、その後の通常処理へ渡します。取得に失敗したときに空のデータで処理を進めないことも、提案する受け入れ条件です。期限切れ、通信失敗、本文の解釈失敗を分けて記録し、どの業務イベントが未完了かを追えるようにします。URLそのものを通常ログへ出す必要はありません。
ここで注意したいのは、配信の再試行期間とURLの有効期限が同じとは限らないことです。受信した小さな本文をキューへ置くだけで、取得を何時間も後回しにできるとは想定しません。expires_atを確認して取得までの時間を管理し、後から業務処理をやり直すために何を保持するかは、データの扱い方と合わせて決めます。
スポンサーリンク
UTF-8のバイト数とEventBridge全体の大きさを分ける
Shopifyの発表は、raw UTF-8本文を1,000,000バイトまで送り、EventBridgeの1 MiBのエントリー上限に対して外側の情報の余裕を残すと説明しています。本文の上限と、sourceやdetail-typeなどを含めたイベント全体の上限は同じ値ではありません。文字数で判定する処理や、256 KBを前提にした独自の拒否条件を棚卸しします。
次はで検証用の本文ファイルを調べる未実行例です。payload.jsonには、受信イベント全体ではなく、配信構造に合わせて取り出した本文だけを保存します。classic webhookのEventBridge例では本文はdetail.payloadにあります。Eventsの入力を同じ位置と決めつけず、使っている配信形式と保存方法をそろえてください。
import { readFileSync } from "node:fs";
const raw = readFileSync(process.argv[2]);
const payload = JSON.parse(raw.toString("utf8"));
console.log({
fileBytes: raw.byteLength,
reserializedBytes: Buffer.byteLength(
JSON.stringify(payload), "utf8"
),
hasPayloadUrl: Object.hasOwn(payload, "payload_url")
});
node inspect-payload.mjs payload.json
fileBytesは保存ファイルの大きさで、改行や空白も含みます。reserializedBytesはを再生成した後の値であり、配信時のraw UTF-8本文をそのまま測った値ではありません。受信後に整形したファイルを使って「Shopifyの上限判定を再現した」と扱わないでください。日本語や絵文字を含むデータでも、文字数とバイト数を別に残します。
ターゲットへ渡す直前の入力を確認する
ShopifyのEventBridge連携手順では、パートナーイベントのルールにLambdaやSQSなどのターゲットを指定します。classic webhookの例では、トピックはdetail.metadata.X-Shopify-Topic、本文はdetail.payloadです。処理先がイベント全体を受けるのか、本文だけを受けるのかを、コードとルールの両方で確認します。
Shopify側で受け付けられる大きさになっても、転送先のサービス、呼び出し方式、、独自のバリデーションが同じ上限とは限りません。ターゲットごとに現在のクォータを調べ、外側のを含む入力サイズで試験します。既存の小さいサンプルだけを使う試験は、今回の変更への確認としては不足します。
AWSの入力変換の資料は、JSONPathで元のイベントの値を取り出し、テンプレートで作った入力をターゲットへ送る仕組みを説明しています。必要な識別情報だけへ絞る方法はありますが、本文を削った後の処理先が何を取得するかも決めます。大きい本文を単に切り捨てて、元と同じ処理ができるとは考えません。
入力変換では、対象のJSONPathが存在しないと変数が作られず、出力に現れない場合があります。通常本文だけでなく、IDのみのclassic webhookとEventsのオーバーフローも使って確認します。すべての経路でdataがあると仮定した変換は避け、変換前後の入力契約を担当者が読める形に残します。
スポンサーリンク
容量を広げる以外に購読の内容を絞る選択もある
ShopifyのWebhook配信構造では、include_fieldsで本文に含めるフィールドを指定できます。すべての商品情報が不要な連携なら、必要なID、更新時刻、対象属性へ絞る案を比較します。Eventsでは購読のqueryで必要な結果を選びます。二つは別の仕組みなので、既存の購読がどちらかを確認してから変更します。
include_fieldsで異なる更新の本文が同一になると、短い時間内の同一本文の配信が間引かれることがあります。公式はupdated_atなどの変化する値を含める方法を案内しています。filterと併用する場合は、その式が参照するフィールドもinclude_fieldsに必要です。サイズだけ減らして、必要な更新を見分ける情報まで消さないようにします。
配送失敗と業務処理の失敗に別の復旧経路を持たせる
AWSのEventBridge再試行方針では、再試行可能な配送エラーに対して、既定で24時間、最大185回まで再送すると説明しています。これはEventBridgeからターゲットへの配送の話です。Lambdaの再試行の資料も、非同期呼び出し、イベントソースマッピングなどで挙動が異なると区別しています。配送成功だけでDB更新や通知が完了したと扱わないことが大切です。
EventBridgeのDLQ資料によると、ルールのターゲットで使うDLQは標準SQSキューで、ルールと同じに置きます。設定しただけで安心せず、配送を失敗させた検証で、イベントとエラー情報を取り出せるか確認します。DLQへ送れた件数だけでなく、送れなかったことを示すInvocationsFailedToBeSentToDLQも監視対象にします。
関数などが受け取った後に失敗する場合は、その処理先の再試行と失敗先を別に確認します。例えばDB保存後の停止では、再実行で同じ業務更新を重ねるおそれがあります。処理済みの識別と更新結果を対応付け、未完了と結果不明を区別して戻す運用を提案します。
Shopifyの重複配信に関する資料は、同じWebhookが再送され得ることと、配信単位の識別にX-Shopify-Webhook-Idを使うことを説明しています。同じ操作から複数の購読へ届く配信は別IDになるため、業務全体の一度きりの実行まで配信IDだけで保証しないでください。今回の容量拡張でも、重複に強い処理は残します。
境界の前後とフォールバックを同じ試験表へ並べる
検証素材には、従来の上限付近、新しい上限より小さい大きな本文、1,000,000バイトを超える本文を用意します。classic webhookとEventsを分け、インラインで届く経路、IDから取得する経路、URLから取得する経路を確認します。ローカルの模擬入力による分岐試験と、検証ストアから実際に配信した試験は別の結果として残します。
同じイベントを再投入する場合、URLの期限切れ、受信先の一時的な停止、処理後の例外も試します。受信件数だけでなく、完了した業務IDと未完了一覧を突き合わせることを完了条件にします。本文を受け取れる容量が増えた利点を生かすには、通常経路を簡単にする変更と、例外時に失わず戻せる確認を一緒に進めてください。
関連記事
LambdaとKafkaのQueueモードで再配信を検証する記事では、成果物の保存後に処理が失敗した場合や、下流の容量を超えない並列度を扱っています。Kafka固有の設定はEventBridgeへ流用せず、再実行と業務完了を分ける設計の参考として参照してください。
スポンサーリンク
参考資料
Shopify:EventBridgeのWebhook本文上限を1 MBへ拡張
Shopify:Events delivery structure
Shopify:Webhooks delivery structure
Shopify:EventBridgeでWebhook購読を作成
AWS:EventBridge input transformation
AWS:EventBridgeの配送再試行
AWS:EventBridgeのDLQ
AWS Lambda:呼び出し方式ごとの再試行
Shopify:配信の確認と重複の識別








