Discord.js获取服务器成员时随机触发TypeError问题求助

问题描述 #

使用Discord.js开发机器人时，执行获取服务器成员操作时随机触发以下错误：

TypeError: Cannot read properties of undefined (reading 'send')
    at C:\Users\darke\Documents\Honorus bot\2\node_modules\discord.js\src\managers\GuildMemberManager.js:504:24
    at new Promise (<anonymous>)
    at GuildMemberManager._fetchMany (C:\Users\darke\Documents\Honorus bot\2\node_modules\discord.js\src\managers\GuildMemberManager.js:501:12)
    at GuildMemberManager.fetch (C:\Users\darke\Documents\Honorus bot\2\node_modules\discord.js\src\managers\GuildMemberManager.js:208:31)
    at Object.execute (C:\Users\darke\Documents\Honorus bot\2\src\commands\Community\interactionGiver.js:19:49)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async Object.execute (C:\Users\darke\Documents\Honorus bot\2\src\events\interactionCreate.js:15:13)

错误表现出随机性：重启机器人后多数情况报错，偶尔能正常运行；确认机器人触发ready事件后仍会出错；在ready事件中执行成员获取操作也会出现相同问题；重装node_modules后仅能正常运行2次就再次报错。

问题根源 #

这个错误本质是Discord.js批量拉取成员时，内部尝试调用一个未定义对象的send方法，核心诱因有两点：

1. 网关连接未完全同步：即使机器人触发ready事件，网关与Discord服务器的连接可能还未完成全量数据同步，此时调用guild.members.fetch()会导致内部请求失败。
2. 缺失必要权限/意图：机器人未开启GUILD_MEMBERS特权网关意图，或者在服务器中没有查看服务器成员权限，导致无法正常拉取成员列表，进而引发内部逻辑错误。

解决方案 #

1. 启用特权网关意图 #

• 登录Discord开发者平台，进入你的机器人应用页面
• 切换到Bot标签页，在Privileged Gateway Intents下开启Server Members Intent
• 代码初始化客户端时显式声明启用该意图：

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMembers, // 必须添加此意图
    // 其他你需要的意图（如GuildMessages等）
  ]
});

2. 等待连接稳定后再执行操作 #

不要在ready事件触发后立即调用成员拉取逻辑，可添加延迟或监听guildCreate事件确保网关同步完成：

client.on('ready', async () => {
  console.log('机器人已就绪');
  // 延迟3秒再执行成员获取操作，给网关留够同步时间
  setTimeout(async () => {
    const targetGuild = client.guilds.cache.get('你的服务器ID');
    if (targetGuild) {
      try {
        const members = await targetGuild.members.fetch();
        console.log(`成功获取${members.size}名成员`);
      } catch (err) {
        console.error('拉取成员失败:', err);
      }
    }
  }, 3000);
});

3. 优化命令代码 #

你的代码中interaction.guild是直接可用的Guild对象，无需await；同时补充错误捕获和完整的角色操作逻辑：

const { SlashCommandBuilder } = require('@discordjs/builders')
const reactionGiverSchema = require('../../reactionGiverSchema')

module.exports = {
    data: new SlashCommandBuilder()
    .setName('reactiongiver')
    .setDescription("给消息添加反应后自动赋予角色")
    .addStringOption(option => option.setName('message_id').setDescription('目标消息的ID').setRequired(true))
    .addChannelOption(option => option.setName('channel').setDescription('消息所在频道').setRequired(true))  
    .addRoleOption(option => option.setName('rôle').setDescription('反应后要赋予的角色').setRequired(true))    
    .addBooleanOption(option => option.setName('reset').setDescription('是否移除已拥有该角色用户的角色').setRequired(true)),
    async execute(interaction, client) {
        const channel = interaction.options.getChannel("channel");
        const role = interaction.options.getRole("rôle");
        const messageId = interaction.options.getString("message_id");
        const needReset = interaction.options.getBoolean("reset");

        if (needReset){
            try {
                // interaction.guild无需await，直接调用即可
                const members = await interaction.guild.members.fetch();
                members.forEach(member => {
                    if (member.roles.cache.has(role.id)) {
                        // 补充移除角色的逻辑，并捕获单个用户操作的错误
                        member.roles.remove(role.id)
                            .catch(err => console.error(`移除${member.user.tag}的角色失败:`, err));
                    }
                });
            } catch (err) {
                console.error('获取成员列表失败:', err);
                return interaction.reply({ content: '重置角色时发生错误', ephemeral: true });
            }
        }

        try {
            await reactionGiverSchema.create({ 
                message_ID: messageId, 
                channel_ID: channel.id, 
                role_ID: role.id 
            });
            await interaction.reply({ content: '创建成功', ephemeral: true });
        } catch (dbErr) {
            console.error('数据库存储失败:', dbErr);
            await interaction.reply({ content: '数据存储出错', ephemeral: true });
        }
    }
}

4. 检查机器人服务器权限 #

确保机器人在目标服务器中拥有查看服务器成员权限，并且机器人的角色位置高于要操作的目标角色（如果涉及角色移除）。

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