Shopify Admin API 偶发 502/504 要不要重试

现象#

批量任务日志里零星出现 502 Bad Gateway 或 504，重跑又成功，不确定是否是自身问题。

原因#

• Shopify 边缘节点短时故障
• 单次请求耗时过长（复杂查询、大文件）超过网关超时
• 客户端连接池配置不合理，复用了失效连接

处理步骤#

1. 对 5xx 与网络错误做指数退避重试（最多 3 次，带抖动）
2. 只对幂等操作重试，写操作配合幂等键或先查后写
3. 拆分耗时查询，单请求控制在 10 秒内
4. 记录 X-Request-Id，便于向 Shopify 支持反馈

验收标准#

偶发 5xx 被自动恢复，任务成功率 99% 以上，无重复写入。