如何通过User对象获取服务器成员？及fetchMember失败问题解决

问题1：如何通过User对象获取服务器（Guild）的所有成员？ #

要通过User对象获取对应服务器的Member对象，或者获取服务器所有成员，你可以参考以下方法：

• 单个成员获取：如果User对象对应的用户在服务器中，优先用guild.members.get(user.id)从本地缓存中获取Member对象；如果缓存中不存在，再调用guild.fetchMember(user)方法从Discord API拉取（针对discord.js v11.x版本）。
• 获取所有服务器成员：使用guild.fetchMembers()方法（v11版本）可以拉取服务器的完整成员列表，但注意这个操作需要机器人拥有服务器成员列表权限，且对于大型服务器建议分批处理，避免触发API速率限制。

问题2：代码频繁无法找到服务器成员的排查与解决 #

我仔细梳理了你的代码和问题描述，这里有几个关键问题和对应的解决方案：

1. 隐藏的拼写错误 #

你的代码里有一处变量拼写错误，这会导致后续操作出现隐性失败：

message.guild.fetchMember(user, false)
.then((memeber) => {
  member.addRole(role) // 这里的`member`未定义，参数名写成了`memeber`（多了一个e）
  // ...
})

修复方法：把参数名统一为member，避免变量未定义错误：

message.guild.fetchMember(user, false)
.then((member) => {
  member.addRole(role)
  // ...
})

2. 并行请求触发API速率限制 #

你用users.map(async user => { ... })并行发起大量fetchMember请求，而Discord API对请求频率有严格限制，批量并行请求很容易被限流，导致请求失败进入catch块。

修复方法：改用串行处理或者控制并发数量，比如用for...of循环串行处理每个用户，降低API请求频率：

react.fetchUsers()
.then(async function(users) {
  var fetchedMemebers = users.size;
  // 串行处理每个用户，避免并发请求过载
  for (const user of users.values()) {
    console.log(user.tag);
    try {
      // 先尝试从缓存获取，缓存没有再调用API拉取
      let member = message.guild.members.get(user.id);
      if (!member) {
        member = await message.guild.fetchMember(user);
      }
      await member.addRole(role);
      await react.remove(user);
    } catch (err) {
      // 针对性处理不同错误场景
      if (err.message.includes('Unknown Member')) {
        console.log(`用户 ${user.tag} 已离开服务器，跳过处理`);
      } else if (err.status === 429) {
        console.log(`触发API速率限制，等待1秒后重试`);
        await new Promise(resolve => setTimeout(resolve, 1000));
        // 可选：添加当前用户的重试逻辑
      } else {
        console.log(`处理用户 ${user.tag} 时出错: ${err.message}`);
      }
    }
  }
  var assignedusers = role.members.size;
  message.reply(`Reacts found: ${reacts}; users fetched: ${fetchedMemebers}; roles assigned: ${assignedusers}`);
})

3. 机器人权限缺失 #

如果机器人没有查看服务器成员的权限，或者未开启Server Members Intent（v11.x版本中虽非强制，但大型服务器需要），fetchMember会无法拉取不在缓存中的成员。

修复方法：

• 在Discord服务器的角色设置中，给机器人分配“查看服务器成员”的权限；
• 在Discord开发者门户的机器人页面，开启Server Members Intent（适用于成员较多的服务器）。

4. 不合理使用缓存参数 #

你调用fetchMember(user, false)时传入了false，意味着不将拉取到的成员存入缓存，后续如果需要再次获取该成员，又要重新发起API请求，增加了失败概率。

修复方法：去掉第二个参数（默认值为true），让机器人缓存拉取到的成员，减少不必要的API请求：

message.guild.fetchMember(user) // 默认缓存成员

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