用途:针对 Shopify 应用在高流量下的稳定性问题,提供处理 API 限流与外部服务故障的策略。Shopify 的 API 限额被比作“漏桶”,请求过快会返回 429 Too Many Requests,应用需要优雅应对。
主要能力:
- 处理限流(429):当收到 429 时,响应会带 Retry-After 头(等待秒数),可据此延迟后重试。示例 fetchWithRetry 用递归与 setTimeout 实现最多 3 次重试。资料提到官方 @shopify/shopify-api 客户端在配置后会自动处理重试。
- 队列与节流:批量操作(如同步 10,000 个商品)不能简单循环 await。可用 bottleneck 控制速率,例如 minTime 500 毫秒、maxConcurrent 5;安装命令为 npm install bottleneck。也可用 BullMQ 将重活移到后台工作进程(资料仅作概念性提及)。
- 熔断:当外部服务(自有后端 API 或承运商)宕机时停止调用,防止级联失败。可用 cockatiel,安装命令为 npm install cockatiel;示例创建重试策略 retry(handleAll, { maxAttempts: 3, backoff: new ExponentialBackoff() }) 与熔断器 CircuitBreaker(handleAll, { halfOpenAfter: 10 * 1000, breaker: new ConsecutiveBreaker(5) }),再用 retryPolicy.execute(() => circuitBreaker.execute(() => fetchMyService())) 执行。
- Webhook 幂等性:Shopify 保证“至少一次”投递,同一 orders/create 可能收到两次。做法是把 X-Shopify-Webhook-Id 存入 Redis/DB 并设短 TTL(如 24h),已存在则忽略请求。
适用场景:高流量 Shopify 应用、批量商品同步、依赖外部服务的集成。
限制:资料未提供价格、平台要求、完整错误处理细节或基准数据;BullMQ 部分仅为概念,未给出完整示例。