Shopify Admin API

Shopify Bulk Operation 一直 running 不结束怎么办

现象#

发起批量导出后,currentBulkOperation 长时间停留在 RUNNING,超过一小时仍未完成,也拿不到结果 URL。

原因#

  • 同一店铺已有一个 bulk 操作在跑,新的请求不会并行执行
  • 查询对象过大(如全量订单行项目)导致服务端处理时间拉长
  • 发起后立即轮询,频率过高触发限流,状态更新被延迟
  • 操作被取消或失败,但代码只判断了 COMPLETED

处理步骤#

  1. 先查 currentBulkOperation,若已有 RUNNING 的先 bulkOperationCancel
  2. 缩小查询范围,按时间切片分批导出,单次不要超过几十万条
  3. 轮询间隔放到 5-10 秒,并处理 FAILED、CANCELED、EXPIRED 状态
  4. 完成后在 7 天内下载 JSONL 结果,过期需重新发起

验收标准#

bulk 操作在预期时间内进入 COMPLETED,结果文件可下载且条数与预期一致。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。