You need to enable JavaScript to run this app. discord.py开发Starboard时on_raw_reaction_add无法获取guild、message属性
优惠活动
大模型
产品
解决方案
定价
更多

discord.py开发Starboard时on_raw_reaction_add无法获取guild、message属性

报错根因

RawReactionActionEvent 本身设计上就不会挂载完整的message、guild实体对象,仅暴露各类关联资源的ID字段以降低内存开销。原代码直接从payload嵌套访问payload.message.guild、payload.message.channel这类不存在的属性,自然会触发属性不存在的报错。

可用的原生属性

完全不需要依赖不存在的嵌套对象,直接通过事件自带的字段就可以匹配你JSON格式的服务器ID-Starboard频道映射逻辑:

  • payload.guild_id:直接返回触发反应的服务器ID,和你JSON存储的键类型完全匹配
  • payload.channel_id:触发反应所在的频道ID
  • payload.message_id:被添加反应的消息ID
  • payload.member:触发本次反应的用户对象
  • payload.emoji:被添加的表情对象
代码修正

修正内容覆盖原代码的所有逻辑问题:

  1. 移除所有不存在的嵌套属性访问,直接用payload.guild_id匹配JSON配置
  2. 通过官方提供的拉取方法获取被加反应的消息实体,解决消息内容、附件、作者信息读取的问题
  3. 调整代码执行顺序,把目标表情判断放到最外层,减少无意义的异步查询
  4. 修复原代码中“设置Embed图片逻辑写在Embed初始化之前导致变量未定义”的隐藏Bug
  5. 移除冗余的重复服务器权限校验逻辑
@client.event
async def on_raw_reaction_add(payload):
    # 非目标表情直接返回,减少后续不必要的操作
    if payload.emoji != '⭐':
        return

    star_config = await get_star_channels()
    guild_id = str(payload.guild_id)
    # 无对应服务器Starboard配置直接返回
    if guild_id not in star_config:
        return

    starchannel = client.get_channel(star_config[guild_id])

    # 触发反应的用户权限校验
    if not payload.member.guild_permissions.manage_messages:
        trigger_channel = client.get_channel(payload.channel_id)
        await trigger_channel.send("You don't have the permissions to star a message")
        return

    # 按需拉取被加反应的消息实体
    trigger_channel = client.get_channel(payload.channel_id)
    target_message = await trigger_channel.fetch_message(payload.message_id)

    # 初始化消息Embed
    embed = discord.Embed(
        description=f"{target_message.author}:\n\n{target_message.content}\n\n**[Jump to message]({target_message.jump_url})**",
        color=random.choice(colors_for_embeds1),
        timestamp=datetime.now()
    )
    # 消息带附件时设置展示图
    if len(target_message.attachments) > 0:
        embed.set_image(url=target_message.attachments[0].url)

    # 设置Embed作者与底部信息
    embed.set_author(
        name=f"{payload.member.name} starred a message",
        icon_url=payload.member.avatar_url
    )
    embed.set_footer(text=f"<#{payload.channel_id}>")

    # 推送Starboard消息
    await starchannel.send(embed=embed)
注意事项

Raw事件对应的消息绝大多数处于客户端缓存范围外,不要假设可以直接从内存中获取消息对象,必须通过fetch_message主动发起拉取,否则会频繁触发缓存未命中的报错。


内容的提问来源于stack exchange,提问作者StatTrakDiamondSword

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.06 04:27:02