Discord机器人反应触发角色分配功能故障求助

问题描述 #

我正在开发一个Discord验证系统，期望实现用户对指定消息做出反应后自动赋予对应角色的功能。查阅了多个Youtube视频、Github仓库和Stack Overflow问题，但始终无法正常运行。

Intents配置 #

intents = discord.Intents.default()
intents.members = True 
intents.messages = True
intents.message_content = True

bot = Bot(command_prefix=commands.when_mentioned_or(
    config["prefix"]), intents=intents, help_command=None)

已在Discord开发者门户中正确配置了Intents。

验证功能代码 #

@bot.event
async def on_raw_reaction_add(payload):
    guild = bot.get_guild(payload.guild_id)
    member = get(guild.members, id=payload.user_id)
    print(1)
    # channel and message IDs should be integer:
    if payload.channel_id == verify_channel_id and payload.message_id == verify_message_id:
        print(2)
        if str(payload.emoji) == "✅":
            print("3.1")
            # name=verified_role_name
            role = get(payload.member.guild.roles, id=945100455678185542)
            print(role)
            print(3)
        else:
            role = get(guild.roles, name=payload.emoji)
            print(role)
            print(payload.emoji)

        if role is not None:
            print(5)
            await payload.member.add_roles(role)
            print(5.1)
            print(f"Assigned {member} to {role}.")


@bot.event
async def on_raw_reaction_remove(payload):
    guild = bot.get_guild(payload.guild_id)
    member = get(guild.members, id=payload.user_id)
    if payload.channel_id == verify_channel_id and payload.message_id == verify_message_id:
        if str(payload.emoji) == "✅":
            print(6)
            role = get(payload.member.guild.roles, name=verified_role_name)
        else:
            role = discord.utils.get(guild.roles, name=payload.emoji)
            print(7)

        if role is not None:
            await member.remove_roles(role)
            print(f"Removed {role} from {member}.")

控制台输出 #

当对消息做出反应时，控制台输出如下（b是要添加的角色）：

1
2
3.1
b 
3
5

之后没有任何后续操作，请求帮助排查问题。

问题排查与修复 #

核心问题 #

on_raw_reaction_add 事件的 payload.member 仅在用户是服务器新成员且刚加入时才有值，对于已在服务器的老用户，payload.member 会是 None。此时执行 await payload.member.add_roles(role) 会抛出异常，但代码未捕获异常，导致流程中断，没有后续输出。

修复方案 #

1. 替换 payload.member 为已获取的 member 对象
   你已经通过 member = get(guild.members, id=payload.user_id) 获取了成员对象，直接用该对象执行角色操作即可。

2. 补充成员缓存缺失的处理
   如果服务器成员较多，guild.members 缓存可能不全，通过 await guild.fetch_member(payload.user_id) 从Discord API拉取最新成员数据。

3. 统一角色获取方式
   混用 get 和 discord.utils.get 易混淆，建议统一使用 discord.utils.get。

4. 添加异常捕获
   给异步操作加 try-except 块，打印异常信息便于调试。

修复后的代码 #

from discord.utils import get

@bot.event
async def on_raw_reaction_add(payload):
    guild = bot.get_guild(payload.guild_id)
    if not guild:
        return
    member = get(guild.members, id=payload.user_id)
    if not member:
        try:
            member = await guild.fetch_member(payload.user_id)
        except Exception as e:
            print(f"无法获取成员 {payload.user_id}: {e}")
            return
    print(1)
    if payload.channel_id == verify_channel_id and payload.message_id == verify_message_id:
        print(2)
        role = None
        if str(payload.emoji) == "✅":
            print("3.1")
            role = get(guild.roles, id=945100455678185542)
            print(role)
            print(3)
        else:
            role = get(guild.roles, name=str(payload.emoji))
            print(role)
            print(payload.emoji)

        if role is not None:
            print(5)
            try:
                await member.add_roles(role)
                print(5.1)
                print(f"Assigned {member} to {role}.")
            except Exception as e:
                print(f"添加角色失败: {e}")

@bot.event
async def on_raw_reaction_remove(payload):
    guild = bot.get_guild(payload.guild_id)
    if not guild:
        return
    member = get(guild.members, id=payload.user_id)
    if not member:
        try:
            member = await guild.fetch_member(payload.user_id)
        except Exception as e:
            print(f"无法获取成员 {payload.user_id}: {e}")
            return
    if payload.channel_id == verify_channel_id and payload.message_id == verify_message_id:
        role = None
        if str(payload.emoji) == "✅":
            print(6)
            role = get(guild.roles, name=verified_role_name)
        else:
            role = get(guild.roles, name=str(payload.emoji))
            print(7)

        if role is not None:
            try:
                await member.remove_roles(role)
                print(f"Removed {role} from {member}.")
            except Exception as e:
                print(f"移除角色失败: {e}")

额外检查项 #

• 确认 verify_channel_id 和 verify_message_id 是整数类型，而非字符串。
• 检查机器人角色权限：机器人的角色必须高于要赋予/移除的目标角色，否则无法执行操作。

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