该技能名为 resilience-engineering(弹性工程),来源为 toilahuongg/google-antigravity-kit,主题是 Shopify 应用的容错与限流处理策略,定位为高流量应用的必备参考。
用途与背景:Shopify 的 API 限额被描述为“漏桶”,请求过快过多会溢出并返回 429 Too Many Requests,应用需优雅处理。
主要能力:
- 处理限流(429)。Shopify 返回 429 时会附带 Retry-After 头(等待秒数)。可用 bottleneck 或自定义延迟实现重试;资料给出 fetchWithRetry 示例,读取 Retry-After 并延迟后重试,最多重试指定次数。并提示官方 @shopify/shopify-api 客户端在配置后可自动处理重试。
- 队列与节流。批量操作(如同步 1 万个商品)不能直接循环 await。示例使用 bottleneck:npm install bottleneck,创建 limiter 设置 minTime(如 500ms 间隔,约每秒 2 次请求)与 maxConcurrent(如 5),再通过 limiter.schedule 调度请求。并提到可将重活移至后台任务(BullMQ),资料将其作为概念提及。
- 熔断器。当外部服务(自有后端 API 或承运商)宕机时,停止调用以防级联失败。示例使用 cockatiel:npm install cockatiel,用 retry 创建重试策略,用 CircuitBreaker 配置 halfOpenAfter 与 ConsecutiveBreaker,组合执行远程调用。
- Webhook 幂等性。Shopify 保证“至少一次”投递,同一 orders/create 可能重复到达。做法是把 X-Shopify-Webhook-Id 存入 Redis 或数据库并设短期 TTL(如 24 小时),若已存在则忽略该请求。
使用方式:需在 Node.js 项目中安装相应依赖(bottleneck、cockatiel 等),按示例组织重试、节流、熔断与幂等逻辑。
适用场景:Shopify 应用开发与高并发同步场景。限制:具体定价、平台版本或完整配置未在资料中提供,缺失信息暂未提供。