Discord API Rate Limiting问题：Express.js仪表盘限流应对最佳实践咨询

1. 缓存已验证会话，避免重复API调用 #

你当前核心问题是每个请求都调用Discord API验证凭证，这完全没必要。用户登录验证通过后，直接在后端缓存其会话状态即可：

• 使用express-session中间件配合connect-mongo，将用户的Discord身份信息（用户ID、权限、令牌有效期等）存储到MongoDB会话中。
• 仅在会话过期、令牌即将失效，或收到令牌无效响应时，才用refresh token获取新的访问令牌，而非每次请求都触发Discord API调用。

2. 利用Discord限流响应头实现智能请求控制 #

Discord返回的限流响应头包含关键控制信息，必须对接逻辑自动调整请求频率：

• X-RateLimit-Limit：当前端点的请求上限
• X-RateLimit-Remaining：剩余可用请求数
• X-RateLimit-Reset：限流重置的时间戳（需转毫秒）
• Retry-After：触发429后需等待的秒数

具体实现思路：

• 为每个Discord API端点维护独立的限流计数器和重置时间，发起请求前先检查剩余配额，不足则等待到重置时间后再请求。
• 收到429响应时，严格按照Retry-After指定的时间等待，禁止立即重试。

示例代码：

const rateLimits = new Map(); // 存储各端点的限流状态

async function callDiscordAPI(endpoint, options) {
  const currentLimit = rateLimits.get(endpoint) || { remaining: Infinity, reset: Date.now() };
  
  // 剩余请求不足时，等待至重置时间
  if (currentLimit.remaining <= 0 && Date.now() < currentLimit.reset) {
    await new Promise(resolve => setTimeout(resolve, currentLimit.reset - Date.now()));
  }

  const response = await fetch(`https://discord.com/api${endpoint}`, options);
  
  // 更新限流状态
  if (response.headers.has('X-RateLimit-Limit')) {
    rateLimits.set(endpoint, {
      remaining: parseInt(response.headers.get('X-RateLimit-Remaining')),
      reset: parseInt(response.headers.get('X-RateLimit-Reset')) * 1000 // 转换为毫秒
    });
  }

  // 处理429重试
  if (response.status === 429) {
    const retryDelay = parseInt(response.headers.get('Retry-After')) * 1000;
    await new Promise(resolve => setTimeout(resolve, retryDelay));
    return callDiscordAPI(endpoint, options); // 递归重试
  }

  return response;
}

3. 优化Refresh Token的使用逻辑 #

你已尝试用refresh token，但可能时机不对：

• Discord访问令牌有效期为15分钟左右，refresh token有效期更长（几天到几周）。
• 仅在访问令牌过期前或收到令牌无效响应时，才调用refresh token接口获取新令牌，不要频繁刷新。
• 将新获取的访问令牌和过期时间更新至MongoDB的用户记录，后续请求直接使用缓存的令牌，无需重复验证。

4. 区分Bot令牌与用户令牌的限流配额 #

Bot令牌和用户令牌的限流额度是相互独立的。你的Bot离线大概率是Bot自身的API请求触发了限流，需将Bot的业务请求与仪表盘的用户验证请求分开处理，各自维护限流计数器。

5. 合并批量请求，减少API调用次数 #

如果有多个同类操作（比如获取多个用户信息），尽量使用Discord提供的批量接口，减少单独请求的次数，从根源降低触发限流的概率。

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