Shopify Bulk Operation 一直 running 不结束怎么办
现象#
发起批量导出后,currentBulkOperation 长时间停留在 RUNNING,超过一小时仍未完成,也拿不到结果 URL。
原因#
- 同一店铺已有一个 bulk 操作在跑,新的请求不会并行执行
- 查询对象过大(如全量订单行项目)导致服务端处理时间拉长
- 发起后立即轮询,频率过高触发限流,状态更新被延迟
- 操作被取消或失败,但代码只判断了
COMPLETED
处理步骤#
- 先查
currentBulkOperation,若已有RUNNING的先bulkOperationCancel - 缩小查询范围,按时间切片分批导出,单次不要超过几十万条
- 轮询间隔放到 5-10 秒,并处理
FAILED、CANCELED、EXPIRED状态 - 完成后在 7 天内下载 JSONL 结果,过期需重新发起
验收标准#
bulk 操作在预期时间内进入 COMPLETED,结果文件可下载且条数与预期一致。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。