Discord.py 批量给全服成员添加角色仅机器人自身生效问题

Discord 网关从v8版本开始引入了权限意图（Intents）机制，默认不会向机器人推送全量服务器成员列表，未开启成员意图时，ctx.guild.members 仅会返回机器人自身的成员对象，这就是为什么循环只执行了一次、只有机器人自己被加上角色。

• 开启开发者后台的成员意图开关
  进入Discord开发者平台，打开你这个机器人对应的应用页面，切到「Bot」配置栏，下滑找到「Privileged Gateway Intents」分区，打开Server Members Intent的开关后保存配置。
• 修改机器人初始化代码，显式声明成员意图
  discord.py 1.5及以上版本要求初始化Bot实例时显式传入意图配置，参考代码如下：

  import discord
  from discord.ext import commands
  
  # 加载默认意图，额外开启成员列表权限
  intents = discord.Intents.default()
  intents.members = True
  
  # 初始化机器人时传入intents参数，替换成你自己的命令前缀
  bot = commands.Bot(command_prefix='!', intents=intents)
  

• 补充原命令的容错逻辑（可选，避免大服务器下报错、触发限流）
  原逻辑没有做前置权限校验，遇到角色层级过高、机器人权限不足的情况会直接报错，可以把命令逻辑优化成下面这样：

  @commands.command(pass_context=True)
  async def test(self, ctx, role: discord.Role):
      # 校验机器人是否有管理角色权限
      if not ctx.guild.me.guild_permissions.manage_roles:
          await ctx.send("缺少管理角色权限，操作终止")
          return
      # 校验目标角色层级是否低于机器人最高角色，Discord规定高角色不能被低角色操作
      if role.position >= ctx.guild.me.top_role.position:
          await ctx.send("目标角色层级高于我的最高角色，无法分配")
          return
      
      success = 0
      for user in ctx.guild.members:
          # 跳过已经持有该角色的成员，减少无效接口请求
          if role in user.roles:
              continue
          try:
              await user.add_roles(role)
              success += 1
              print(f"[+] {user.name} 已分配角色：{role.name}")
          except Exception as e:
              print(f"[-] 给{user.name}分配角色失败：{str(e)}")
      
      await ctx.send(f"操作执行完成，共为{success}名成员添加了指定角色")
  

改完重启机器人就能正常遍历全服成员加角色了。

内容的提问来源于stack exchange，提问作者deadinside