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:触发反应所在的频道IDpayload.message_id:被添加反应的消息IDpayload.member:触发本次反应的用户对象payload.emoji:被添加的表情对象
代码修正
修正内容覆盖原代码的所有逻辑问题:
- 移除所有不存在的嵌套属性访问,直接用
payload.guild_id匹配JSON配置 - 通过官方提供的拉取方法获取被加反应的消息实体,解决消息内容、附件、作者信息读取的问题
- 调整代码执行顺序,把目标表情判断放到最外层,减少无意义的异步查询
- 修复原代码中“设置Embed图片逻辑写在Embed初始化之前导致变量未定义”的隐藏Bug
- 移除冗余的重复服务器权限校验逻辑
@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
相关产品推荐
相关产品推荐

