Discord.js批量移除角色后添加初始角色失效问题求助

我尝试移除服务器所有用户的所有角色并添加初始角色，移除角色与清除昵称功能已正常运行，但添加初始角色时无法覆盖所有成员；此前还出现过如下API超时错误：

{
  timeout: 6998,
  limit: 10,
  method: 'patch',
  path: '/guilds/951903386557636729/members/1027401729962168350',
  route: '/guilds/951903386557636729/members/:id',
  global: false
}

相关代码如下：
移除角色：

await interaction.guild.members.cache.forEach(m => {
    m.roles.remove(m.roles.cache)
});

清除昵称：

setTimeout(() => interaction.guild.members.cache.forEach(m => {
    m.setNickname("")
}), 30 * 60000)

添加初始角色：

setTimeout(() => interaction.guild.members.cache.forEach(m => {
    (m.roles.add(entradacargo)) 
}), 31 * 60000)

请问如何解决添加初始角色无法覆盖所有成员的问题？

1. 主动拉取所有成员，不依赖缓存 #

interaction.guild.members.cache仅包含机器人已缓存的成员，离线时间久或新加入的用户可能不在其中。必须主动拉取服务器全量成员：

async function addInitialRoleToAll() {
  const guild = interaction.guild;
  // 分批拉取所有成员，避免单次请求超限
  await guild.members.fetch({ limit: 1000 });
  
  // 串行遍历成员，避免并发请求触发API限制
  for (const [id, member] of guild.members.cache) {
    try {
      // 跳过机器人，避免无意义操作
      if (member.user.bot) continue;
      await member.roles.add(entradacargo);
      // 添加小延迟，控制请求频率
      await new Promise(resolve => setTimeout(resolve, 100));
    } catch (err) {
      console.error(`给成员 ${id} 添加角色失败:`, err);
    }
  }
}

setTimeout(addInitialRoleToAll, 31 * 60000);

2. 处理API速率限制与超时 #

你遇到的超时错误源于Discord API的请求频率限制，批量操作必须做限流：

• 用for...of串行执行请求，替代forEach的并行发起，避免瞬间打满API额度
• 每个请求后添加100ms左右的延迟，降低触发限制的概率
• 捕获单个请求的错误，防止某一个成员操作失败导致整个流程中断

3. 优化其他批量操作逻辑（同步修复缓存问题） #

移除角色和清除昵称的代码同样存在缓存覆盖不全的问题，建议同步修改：

移除角色优化版 #

async function removeAllRoles() {
  const guild = interaction.guild;
  await guild.members.fetch({ limit: 1000 });
  
  for (const [id, member] of guild.members.cache) {
    try {
      // 跳过机器人和管理员，避免权限冲突
      if (member.user.bot || member.permissions.has('ADMINISTRATOR')) continue;
      await member.roles.remove(member.roles.cache);
      await new Promise(resolve => setTimeout(resolve, 100));
    } catch (err) {
      console.error(`移除成员 ${id} 角色失败:`, err);
    }
  }
}

await removeAllRoles();

清除昵称优化版 #

async function clearAllNicknames() {
  const guild = interaction.guild;
  await guild.members.fetch({ limit: 1000 });
  
  for (const [id, member] of guild.members.cache) {
    try {
      if (member.user.bot) continue;
      await member.setNickname("");
      await new Promise(resolve => setTimeout(resolve, 100));
    } catch (err) {
      console.error(`清除成员 ${id} 昵称失败:`, err);
    }
  }
}

setTimeout(clearAllNicknames, 30 * 60000);

4. 检查机器人权限与角色层级 #

• 确保机器人拥有MANAGE_ROLES权限
• 要添加的初始角色，其角色层级必须低于机器人自身的角色层级（Discord不允许机器人管理比自己层级高的角色）

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