Bottleneck配置疑问：调用第三方API偶发Rate Limit错误排查

你的配置确实存在规则不匹配的问题 #

第三方API是固定窗口每分钟100次调用，但当前Bottleneck配置和该规则未对齐，这是偶尔触发限流错误的核心原因：

• 你设置的reservoir和reservoirRefreshAmount都是80，相当于每分钟只分配了80次调用额度，结合minTime:750（每分钟最多触发80次调用），两种限流逻辑叠加后，在窗口切换的边界点可能出现调用次数溢出——比如上一个窗口末尾用满80次，下一个窗口刚刷新就发起请求，两个窗口的调用次数叠加可能超过API的100次限制。
• Bottleneck默认的reservoirRefreshType是滑动窗口模式，和第三方API的固定窗口计数规则不兼容，这也是偶尔超限制的诱因之一。

修正后的配置（完全匹配API规则） #

const limiter = new Bottleneck({
  maxConcurrent: 1,
  // 匹配API的每分钟100次调用额度
  reservoir: 100,
  reservoirRefreshAmount: 100,
  reservoirRefreshInterval: 60 * 1000,
  // 开启固定窗口模式，与API规则完全对齐
  reservoirRefreshType: 'fixed',
  datastore: ['development', 'production'].includes(process.env.APP_ENVIRONMENT!) ? 'ioredis' : 'local',
  clearDatastore: false,
  clientOptions: {
    host: process.env.REDIS_HOST,
    port: process.env.REDIS_PORT,
    tls: {},
  },
  id: 'api-rate-limit',
})

关键调整说明 #

1. 将reservoir和reservoirRefreshAmount改为100，完全匹配API的每分钟调用上限。
2. 新增reservoirRefreshType: 'fixed'，强制使用固定窗口模式，确保每60秒准时重置调用额度，和第三方API的计数逻辑完全同步。
3. 移除minTime:750：固定窗口模式下无需通过间隔时间限制调用频率，只要总次数不超限即可。如果需要让调用更平滑（避免短时间集中请求），可以改为minTime:600（每分钟100次的平均间隔）。

额外排查点 #

如果调整后仍偶尔出现限流错误，检查以下两点：

• 定时任务是否存在多实例重复执行的情况？如果是分布式部署，需要添加Redis分布式锁，确保同一时间只有一个实例运行定时任务。
• 你的服务器时间与第三方API的服务器时间是否存在偏差？固定窗口是按API服务器时间计算的，时间差可能导致窗口计算错位。

内容的提问来源于stack exchange，提问作者Dcode