Shopify Admin GraphQL 报 THROTTLED 怎么控制查询成本

现象#

一次查询多个商品及其变体、图片、metafields，返回 THROTTLED，重试后仍然失败。

原因#

• 单次查询 requestedQueryCost 超过 1000 点上限
• 嵌套层级深，每个连接都取 first: 250
• 并发多个高成本查询，桶容量被打空

处理步骤#

1. 查询里加 extensions { cost { requestedQueryCost actualQueryCost throttleStatus { currentlyAvailable restoreRate } } }
2. 把大查询拆成多次小查询，每次 first: 50 以内
3. 按 currentlyAvailable / restoreRate 计算等待时间再发下一批
4. 非实时场景改用 Bulk Operation 导出全量

验收标准#

批量任务不再出现 THROTTLED，cost 指标稳定在容量 60% 以下，数据完整。