You need to enable JavaScript to run this app. Discord机器人message.channel.members未包含文本频道全部用户异常咨询
优惠活动
大模型
产品
解决方案
定价
更多

Discord机器人message.channel.members未包含文本频道全部用户异常咨询

问题根因

该异常并非代码逻辑错误,即便回退到数天前的稳定版本仍出现相同问题的核心原因是:Discord于2024年10月28日前后,对所有未显式开启「服务器成员特权意图」的机器人,强制收紧了成员数据缓存权限。该调整未面向普通开发者发布全量正式公告,导致大量长期稳定运行的老bot集体出现功能失效。

权限调整的具体影响

  • 调整前,机器人默认可无门槛获取全量服务器成员缓存,message.channel.members可覆盖当前文本频道内所有可见用户,即使用户从未发送过消息、未处于语音频道,也会被纳入成员集合,这是此前随机成员指令可正常运行数周的基础。
  • 调整后,未开通对应权限的机器人,本地成员缓存仅会自动收录两类用户:
    • 与机器人存在直接交互、主动向机器人发送过消息的用户
    • 处于服务器语音频道内的在线用户
  • 该规则可完整解释所有异常表现:无语音用户在线、仅单个用户触发指令时,缓存内仅存在触发者和机器人本身;邀请其他用户触发指令后,对方因主动交互被纳入缓存才会出现在成员列表中;从未发言的普通用户因不满足缓存触发条件,不会被纳入成员集合,自然无法被随机指令选中。

修复操作步骤

  • 第一步:登录Discord开发者后台,找到对应机器人的应用设置页,在「特权意图」板块,手动开启**服务器成员意图(Server Members Intent)**开关并保存配置。
  • 第二步:修改机器人的客户端初始化代码,在实例化bot时显式声明该意图,否则即便后台开关已开启,网关连接时也不会拉取对应的成员数据。以discord.js v14版本为例,初始化代码参考如下:
const { Client, GatewayIntentBits } = require('discord.js');
const bot = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.GuildMembers // 必须显式声明该意图
    ]
});
  • 第三步:优化随机成员指令的取值逻辑,过滤无效的机器人账号,避免随机结果误提bot,提升指令稳定性。修改后的random_member.js参考如下:
module.exports = {
    name: 'random_member',
    usage: 'random_member',
    description: "random_member",
    execute(message, args) {
        // 从频道成员缓存中过滤掉bot账号,再随机抽取有效用户
        const validMembers = message.channel.members.cache.filter(member => !member.user.bot);
        const randomMember = validMembers.random();
        message.channel.send(`${randomMember}`);
    }
}

补充说明

  • 若机器人已接入超过100个服务器,属于公共应用范畴,开启「服务器成员意图」需按Discord要求提交申请审核;仅在私人/好友服务器内使用的bot,直接开启开关即可生效,无需审核。
  • 此前观察到语音频道用户会出现在成员列表的现象,本质是语音状态变动属于网关主动推送的事件,不需要额外的成员权限即可被机器人接收,因此这类用户会自动被纳入本地缓存,无需特殊处理。

内容的提问来源于stack exchange,提问作者Hakej

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 16:54:01