You need to enable JavaScript to run this app. discord.py中调用ctx.guild.members获取成员列表仅返回机器人自身
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.21 09:24:03