Discord.js实现机器人过滤 解决成员统计误含机器人的问题
Discord.js 成员统计过滤失效的常见原因与修正方案
核心问题点
- 缓存加载不全:默认状态下Discord.js仅将机器人启动后交互过的成员存入本地缓存,直接从
guild.members获取的集合没有覆盖全量服务器成员,此时做过滤运算得到的结果自然和实际值有偏差。如果未在Discord开发者后台开启服务器成员意图(Server Members Intent),机器人根本无法获取完整的成员列表,过滤得到的数值会长期不准。 - 版本语法不兼容:Discord.js v13及以上版本中,可遍历的成员集合的访问路径已经调整为
guild.members.cache,原代码中直接对guild.members做filter的写法,无法拿到正确的可遍历集合,会导致过滤逻辑完全失效。 - 接口限频触发拦截:原代码设置1秒间隔调用频道改名接口,远低于Discord API的限频阈值,会触发接口拦截,导致改名操作失败、统计值不更新,严重时还会触发机器人账号的临时接口封禁。
修正后的可运行代码
client.on('ready', async () => { // 先实时拉取目标服务器对象 const guild = await client.guilds.fetch("74721732........."); // 拉取全量成员到本地缓存,需要提前开启对应网关意图 await guild.members.fetch(); // 将定时器间隔调整为15分钟,规避API限频 setInterval(async () => { // 从缓存集合中筛选非机器人成员 const humanMemberCount = guild.members.cache.filter(member => !member.user.bot).size; // 实时拉取目标统计频道对象,避免缓存过期报错 const countChannel = await client.channels.fetch("81358139........."); await countChannel.setName(`Members: ${humanMemberCount}`); }, 15 * 60 * 1000); })
实操注意事项
- 未申请特权的普通机器人,每小时调用全量成员拉取接口的次数有硬限制,不要把拉取全量成员的逻辑放在高频定时器里,机器人启动时拉取一次、每数小时按需刷新一次即可。
- 不要直接依赖静态缓存值操作guild、channel这类跨节点对象,操作前用
fetch()方法拉取实时数据,避免因为缓存过期、缓存值失效出现操作报错。
内容的提问来源于stack exchange,提问作者Andryxa
相关产品推荐
相关产品推荐

