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 _
相关产品推荐
相关产品推荐

