discord.py中调用ctx.guild.members获取成员列表仅返回机器人自身
问题原因
该问题由Discord特权意图权限限制导致:
discord.py 2.0及以上版本默认关闭Server Members Intent(服务器成员特权意图),未手动开启该权限时,机器人仅能获取自身用户信息,无法拉取服务器内全量成员列表,你编写的命令逻辑本身没有问题。
解决方案
需要同时完成两处配置才能正常获取成员列表:
1. 在Discord开发者后台开启对应权限
- 进入Discord开发者平台对应机器人应用的管理页面,打开左侧菜单栏的「Bot」配置页
- 下滑找到「Privileged Gateway Intents」配置板块,开启
SERVER MEMBERS INTENT的开关后保存修改
2. 在代码中声明启用成员意图
修改机器人客户端的初始化代码,手动声明加载成员意图即可,示例代码如下:
from discord.ext import commands import discord # 加载默认基础意图+开启成员意图 intents = discord.Intents.default() intents.members = True # 初始化客户端时传入配置好的intents(根据你原本的前缀参数调整即可) client = commands.Bot(command_prefix="!", intents=intents)
完成上述配置后,你原有编写的members命令可正常运行,会依次输出所有服务器成员的用户名。
注意:若你的机器人已被超过100个服务器邀请使用,需要先向Discord提交申请验证才能正常使用该特权意图,自用小型机器人无需提交申请。
内容的提问来源于stack exchange,提问作者Hyper
相关产品推荐
相关产品推荐

