You need to enable JavaScript to run this app. discord.py机器人无法获取服务器全量成员 仅返回11个
优惠活动
大模型
产品
解决方案
定价
更多

discord.py机器人无法获取服务器全量成员 仅返回11个

问题定位

你遇到的拿不全成员的问题,和你写的遍历逻辑、定时任务实现完全没关系,根本原因是Discord的特权网关意图没配置对。
没开对应权限的时候,Discord网关只会给机器人推送极小范围的成员子集:包含机器人自身、服务器的管理员账号、和机器人有过直接交互的用户,凑起来刚好就是你看到的固定11个成员的来源,完全匹配你的观察结果。

解决方案

分两步把配置改完,就能正常拿到全量成员列表:

  • 第一步:去Discord开发者后台开平台层面的权限
    1. 找到你对应机器人的应用管理页,点侧边栏的「Bot」设置项
    2. 往下滑到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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.18 17:06:09