discord.js机器人通过GUILD_MEMBERS后统计总用户数异常求助

核心错误原因 #

• 权限意图配置未生效
  仅在Discord开发者后台通过GUILD_MEMBERS意图验证不生效，必须在客户端初始化代码中显式声明该意图，权限才能正常启用。
• 缓存并非全量数据
  client.users.cache默认仅存储与机器人有过交互、处于活跃状态的用户数据，不会自动缓存所有服务器的全部成员，直接取size得到的数值会远小于实际总用户数。
• 分片部署未汇总数据
  如果机器人接入服务器超过2500个，Discord要求必须分片部署，单独取单个分片的缓存数据只会返回当前分片的用户数，不会汇总所有分片的统计结果。

正确统计总用户数的实现方案 #

方案1：单分片机器人实现 #

通过遍历所有服务器拉取全量成员后累加统计，建议定时统计后缓存结果，不要每次请求都实时拉取避免触发速率限制：

async function getTotalUsers() {
  const allUserIds = new Set();
  // 遍历所有服务器拉取全量成员
  for (const guild of client.guilds.cache.values()) {
    const members = await guild.members.fetch();
    members.forEach(member => allUserIds.add(member.id));
    // 服务器数量较多时可在这里加1-2秒延迟，避免触发速率限制
  }
  // 返回去重后的总用户数，如果不需要去重直接累加members.size即可
  return allUserIds.size;
}

v14及以上版本初始化示例：

const { Client, IntentBits } = require('discord.js');
const client = new Client({
  intents: [
    IntentBits.Guilds,
    IntentBits.GuildMembers, // 必须显式声明该意图
    // 其他业务需要的意图
  ]
})

方案2：分片机器人实现 #

需要汇总所有分片的统计结果：

async function getShardedTotalUsers() {
  const shardCounts = await client.shard.broadcastEval(c => {
    const userIds = new Set();
    c.guilds.cache.forEach(g => g.members.cache.forEach(m => userIds.add(m.id)));
    return userIds.size;
  });
  return shardCounts.reduce((acc, count) => acc + count, 0);
}

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