You need to enable JavaScript to run this app. Python开发Discord bot guild.members返回与member_count不匹配
优惠活动
大模型
产品
解决方案
定价
更多

Python开发Discord bot guild.members返回与member_count不匹配

问题核心原因

该现象是discord.py v2.0版本后的特权意图权限缺失导致的,不属于代码逻辑错误:

  • guild.member_count是服务器基础元数据自带字段,无需特殊权限即可返回准确值
  • guild.members的完整成员列表需要申请并开启**服务器成员意图(Server Members Intent)**权限,未授权时Discord只会返回bot自身的成员条目
修复步骤

1. 开发者后台开启对应权限

  • 进入目标bot的开发者应用管理页,选择「Bot」配置栏
  • 下拉找到「Privileged Gateway Intents」板块,打开「Server Members Intent」开关并保存配置

2. 代码中手动启用意图

默认的discord.Intents.default()配置不会自动开启成员意图,需要手动补充权限声明:

无权限的默认配置:

intents = discord.Intents.default()
client = discord.Client(intents=intents)

可正常获取成员列表的配置:

intents = discord.Intents.default()
intents.members = True # 手动开启服务器成员意图
client = discord.Client(intents=intents)

若使用commands.Bot开发,配置逻辑完全一致:

intents = discord.Intents.default()
intents.members = True
bot = commands.Bot(command_prefix="!", intents=intents)
补充说明

若bot后续加入成员数超过100人的服务器,开启该特权意图后需要提交bot功能审核才能正常使用;当前测试服务器仅3人,无审核要求,配置完成后重启bot即可拉取到全量成员列表。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.23 01:24:04