Discord机器人实现反应角色功能时报Unknown Emoji错误且表情不可点击怎么解决？

触发报错的核心原因 #

• 代码中定义的 Pug_Emoji = ':gun:' 属于Discord客户端的短代码语法，这类带冒号的标识仅在用户聊天输入框中会被前端解析为对应表情，直接传入机器人开放API接口时无法被识别，是控制台抛出 DiscordAPIError: Unknown Emoji 错误、消息中表情无法交互的核心诱因。
• 调用 messageEmbed.react(Pug_Emoji) 时，因为传入的表情参数无效，API会返回拒绝状态的Promise，代码没有对这个调用做异常捕获，才会触发控制台的 UnhandledPromiseRejectionWarning 告警。
• 嵌入消息内使用带冒号的短代码拼接内容时，Discord不会自动将其渲染为可交互的表情实体，仅会显示纯文本的 :gun: 字符串，用户自然无法触发点击反应。
• 传入API的表情需要使用真实可解析的格式：
  • 系统默认Emoji：直接传入Unicode字符本体，替换为 Pug_Emoji = '🔫' 即可
  • 服务器自定义Emoji：传入完整格式 <:表情名称:表情ID>，不能使用短代码

代码结构存在的隐患 #

• 将 messageReactionAdd、messageReactionRemove 事件监听绑定在 reactionrole 指令的执行方法内，每执行一次指令就会重复绑定一次全局事件监听，长期运行会出现重复触发角色增减、内存泄漏的问题，需要将这部分事件逻辑独立放到机器人全局事件初始化的位置，不要嵌入单条指令的执行流程中。
• 若客户端初始化时未开启对应 Partials 配置，机器人无法获取未被内部缓存的消息、反应对象，即使表情格式正确，也会出现交互无响应的问题。

关键代码修正点 #

• 替换错误的表情定义：

// 错误写法
// const Pug_Emoji = ':gun:';
// 正确写法，直接传入系统Emoji的Unicode字符
const Pug_Emoji = '🔫';

• 修正后嵌入消息会自动渲染真实表情，调用 messageEmbed.react(Pug_Emoji) 时也可以成功为消息添加反应。
• 客户端初始化时补充必要的参数配置：

const client = new Discord.Client({
    partials: ['MESSAGE', 'CHANNEL', 'REACTION'],
    intents: [/* 按权限要求配置Guilds、GuildMessageReactions等对应意图 */]
});

• 反应事件内的判断逻辑无需调整，因为修改后 Pug_Emoji 存储的就是真实表情的名称，和 reaction.emoji.name 的取值可以直接匹配。

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