forEach循环中Discord机器人权限错误的异常捕获问题

问题背景 #

需要在多个Discord服务器同步用户属性，以timeout操作为测试时遇到以下问题：

• 最初用.catch()捕获错误时，单个服务器权限不足会导致所有服务器都输出错误日志，捕获逻辑混乱
• 改用forEach内的try/catch时，因timeout是异步操作，权限不足直接导致机器人崩溃
• 用户对象仅从触发命令的服务器缓存获取，跨服务器操作时无法确认用户是否存在于目标服务器

现有代码与问题 #

最初代码及异常表现 #

client.guilds.cache.forEach(a => {
    userObject.timeout(60 * 1000, 'test of function').catch((err) => {console.log(`Invalid perms to change property in ` + a.name);});
});

问题：权限正常的服务器仅触发命令的服务器生效，只要有一个服务器权限异常，所有服务器都会输出错误日志，错误捕获逻辑失效。

改用try/catch后的崩溃问题 #

client.guilds.cache.forEach(a => {
    try {
    userObject.timeout(60 * 1000, 'test of function')
    }catch(err) {console.log(`Invalid perms to change property in ` + a.name);}
});

崩溃错误日志：

C:\Protocol7\Bot\node_modules\@discordjs\rest\dist\index.js:687
      throw new DiscordAPIError(data, "code" in data ? data.code : data.error, status, method, url, requestData);
            ^

DiscordAPIError[50013]: Missing Permissions
    at handleErrors (C:\Protocol7\Bot\node_modules\@discordjs\rest\dist\index.js:687:13)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async SequentialHandler.runRequest (C:\Protocol7\Bot\node_modules\@discordjs\rest\dist\index.js:1072:23)
    at async SequentialHandler.queueRequest (C:\Protocol7\Bot\node_modules\@discordjs\rest\dist\index.js:913:14)
    at async _REST.request (C:\Protocol7\Bot\node_modules\@discordjs\rest\dist\index.js:1218:22)
    at async GuildMemberManager.edit (C:\Protocol7\Bot\node_modules\discord.js\src\managers\GuildMemberManager.js:381:15) {
  requestBody: {
    files: undefined,
    json: {
      communicationDisabledUntil: -,
      communication_disabled_until: -
    }
  },
  rawError: { message: 'Missing Permissions', code: 50013 },
  code: 50013,
  status: 403,
  method: 'PATCH',
  url: 'https://discord.com/api/v10/guilds/-/members/-'
}

用户对象获取方式 #

userObject = message.guild.members.cache.get(args[0]);

解决方案 #

1. 修正异步错误捕获与前置校验 #

使用async/await配合try/catch正确捕获异步错误，同时在执行操作前加入权限与用户存在性校验：

client.guilds.cache.forEach(async (guild) => {
    try {
        // 检查机器人当前服务器是否拥有禁言权限
        const botMember = guild.members.me;
        if (!botMember.permissions.has('MODERATE_MEMBERS')) {
            console.log(`机器人在服务器 ${guild.name} 缺少禁言权限`);
            return;
        }

        // 检查用户是否存在于当前服务器（缓存无数据时自动从API拉取）
        const targetMember = await guild.members.fetch(args[0]).catch(() => null);
        if (!targetMember) {
            console.log(`用户不在服务器 ${guild.name} 中`);
            return;
        }

        // 执行timeout操作
        await targetMember.timeout(60 * 1000, 'test of function');
        console.log(`已在服务器 ${guild.name} 成功禁言用户`);
    } catch (err) {
        // 捕获其他API异常
        console.log(`服务器 ${guild.name} 执行操作失败: ${err.message}`);
    }
});

2. 核心优化点 #

• 权限预校验：提前检查机器人权限，避免无效API请求
• 用户存在性验证：通过fetch()确保用户在目标服务器，避免基于单个服务器缓存的无效操作
• 异步错误正确捕获：async/await搭配try/catch，确保异步操作的错误被精准捕获，不会导致全局崩溃
• 独立处理每个服务器：每个服务器的操作完全隔离，单个服务器的错误不会影响其他服务器执行

3. 额外建议 #

• 批量操作时加入固定延迟（如await new Promise(resolve => setTimeout(resolve, 1000));），避免触发Discord API速率限制
• 服务器数量较多时，可使用Promise.all()配合并发限制工具，提升执行效率同时规避限流风险

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