Discord.js机器人调用指令批量私信全服成员仅能发送给4名管理员问题

• 首先确认配置项：你需要先进入Discord开发者平台的机器人管理页，在「Bot」设置板块找到*特权网关意图（Privileged Gateway Intents）*分类，开启Server Members Intent开关，否则Discord会限制机器人获取全量服务器成员列表，仅能拿到少量有权限、近期活跃的成员数据。
• 原有代码问题1：仅遍历本地缓存的成员列表，Discord.js默认不会将服务器所有成员预加载到本地缓存，message.guild.members.cache仅包含少量缓存成员，导致大部分成员没有被遍历到。
• 原有代码问题2：错误捕获逻辑失效，catch回调仅返回错误字符串没有输出日志，无法排查问题；且将成功提示放在循环内，不管私信是否发送成功都会重复触发频道消息发送，逻辑不合理。

修复后代码示例 #

// 初始化Client时必须注册GuildMembers意图，示例初始化代码参考：
// const { Client, GatewayIntentBits } = require('discord.js');
// const client = new Client({
//   intents: [
//     GatewayIntentBits.Guilds, // 服务器基础意图
//     GatewayIntentBits.GuildMessages, // 服务器消息意图
//     GatewayIntentBits.MessageContent, // 消息内容读取意图
//     GatewayIntentBits.GuildMembers, // 服务器成员读取意图，必须开启
//   ]
// });

// 指令触发后的执行逻辑
async function massSendDM(message) {
  try {
    // 主动拉取服务器全量成员列表，而非仅读取本地缓存
    const allGuildMembers = await message.guild.members.fetch();
    let successNum = 0;
    let failNum = 0;

    for (const member of allGuildMembers.values()) {
      // 跳过所有机器人账号，避免给自身/其他机器人发消息
      if (member.user.bot) continue;
      try {
        await member.send('hi');
        successNum++;
      } catch (err) {
        console.log(`无法向成员 ${member.user.tag} 发送私信，原因：${err.message}`);
        failNum++;
      }
    }

    // 所有发送任务执行完毕后统一返回结果
    await message.channel.send(`批量发送完成：成功发送${successNum}人，发送失败${failNum}人（失败多为用户隐私设置禁止接收陌生成员私信）`);
  } catch (err) {
    console.error('拉取服务器成员列表失败：', err);
    await message.channel.send('拉取成员列表失败，请检查机器人权限与意图配置是否正确');
  }
}

// 调用执行函数
massSendDM(message);

注意：短时间内大量批量发送私信很容易被Discord判定为垃圾消息违规行为，可能导致机器人被风控甚至封禁，建议控制发送频率，避免违反Discord平台规则。

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