discord.py机器人无法获取服务器全量成员 仅返回11个
问题定位
你遇到的拿不全成员的问题,和你写的遍历逻辑、定时任务实现完全没关系,根本原因是Discord的特权网关意图没配置对。
没开对应权限的时候,Discord网关只会给机器人推送极小范围的成员子集:包含机器人自身、服务器的管理员账号、和机器人有过直接交互的用户,凑起来刚好就是你看到的固定11个成员的来源,完全匹配你的观察结果。
解决方案
分两步把配置改完,就能正常拿到全量成员列表:
- 第一步:去Discord开发者后台开平台层面的权限
- 找到你对应机器人的应用管理页,点侧边栏的「Bot」设置项
- 往下滑到Privileged Gateway Intents的配置区,打开「Server Members Intent」的开关,保存就行
重点注意:这个开关是平台强制要求的,必须手动在后台点,光在代码里写配置根本不生效。
- 第二步:在代码里初始化客户端的时候显式声明要用这个意图
不能靠默认配置,要手动构造带成员读取权限的意图对象:# 先加载默认的基础意图 intents = discord.Intents.default() # 打开成员列表的读取权限 intents.members = True # 把配置好的intents传给客户端,不管你用的是基础Client还是commands.Bot,都要传这个参数 client = discord.Client(intents=intents)
顺带提几个不用改的点和常见坑
- 你写的定时任务里加的
aio.sleep(0.05)间隔是对的,能避免触发Discord的接口速率限制,根本不用改。 - 你用
for guild in client.guilds的写法也没问题,不管单服务器还是多服务器部署都兼容,和官方文档的遍历方式一致,不需要调整。 - 刚配完第一次跑任务的时候,可能还是显示不全,因为Discord的成员列表是异步同步的,等一个循环周期(也就是你设的60秒)之后,列表加载完就正常了,不用慌。
- 后面要是你的机器人所在服务器人超过100个,得在开发者后台过一下意图的合规验证,不然开了的权限也会被平台限制。
内容的提问来源于stack exchange,提问作者Moondancer
相关产品推荐
相关产品推荐

