You need to enable JavaScript to run this app. 如何让raw事件仅执行一次 解决反应操作时事件重复触发问题
优惠活动
大模型
产品
解决方案
定价
更多

如何让raw事件仅执行一次 解决反应操作时事件重复触发问题

重复触发根因

当前代码的重复触发来自异步逻辑的竞态漏洞:

  • 去重判断channel.messages.cache.has(packet.d.message_id)是同步执行的
  • 当第一条反应相关的raw包到达时,代码发起的channel.messages.fetch()是异步网络请求,在请求返回、消息写入本地缓存之前,短时间内网关重复推送的同一条反应操作raw包,都会通过这个同步的缓存检查,发起多次冗余的消息拉取,最终重复执行后面的事件emit逻辑。
修复方案

核心思路是给同一条消息的进行中fetch请求加临时去重锁,保证同一条消息的拉取逻辑只执行一次,等拉取完成、消息进入本地缓存后,自然由原有逻辑拦截后续的重复请求:

  • 用内存Map存储当前正在进行的消息fetch Promise,键值用频道ID:消息ID拼接避免不同频道的同ID消息冲突
  • 收到raw包时,先判断有没有对应消息的进行中fetch请求,存在就直接跳过
  • fetch请求不管成功还是失败,都在finally阶段移除对应的去重锁,避免永久阻塞正常请求
修复后完整代码
// 优先在客户端实例初始化阶段挂载这个存储Map,避免每次事件触发重复初始化
this._pendingMessageFetches = this._pendingMessageFetches || new Map();

this.on('raw', packet => {
    if (!['MESSAGE_REACTION_ADD', 'MESSAGE_REACTION_REMOVE'].includes(packet.t)) return;
    const { channel_id: channelId, message_id: messageId, user_id: userId, emoji } = packet.d;
    const channel = this.channels.cache.get(channelId);
    if (!channel) return; // 兼容频道不存在的异常场景
    
    // 已在本地消息缓存的直接走原有逻辑拦截
    if (channel.messages.cache.has(messageId)) return;

    const pendingKey = `${channelId}:${messageId}`;
    // 存在同一条消息的进行中fetch请求,直接跳过避免重复执行
    if (this._pendingMessageFetches.has(pendingKey)) return;

    // 发起消息拉取,把Promise存入去重Map
    const fetchProcess = channel.messages.fetch(messageId)
        .then(message => {
            const emojiKey = emoji.id ? `${emoji.name}:${emoji.id}` : emoji.name;
            const reaction = message.reactions.cache.get(emojiKey);
            if (reaction) reaction.users.cache.set(userId, this.users.cache.get(userId));
            
            if (packet.t === 'MESSAGE_REACTION_ADD') {
                this.emit('messageReactionAdd', reaction, this.users.cache.get(userId));
            }
            if (packet.t === 'MESSAGE_REACTION_REMOVE') {
                this.emit('messageReactionRemove', reaction, this.users.cache.get(userId));
            }
        })
        .finally(() => {
            // 拉取流程结束后释放去重锁,避免残留
            this._pendingMessageFetches.delete(pendingKey);
        });

    this._pendingMessageFetches.set(pendingKey, fetchProcess);
});
注意事项
  • 这套去重逻辑不需要额外引入持久化存储,所有临时锁都会在请求完成后自动清理,不会造成内存泄漏
  • 兼容异常场景:如果频道不存在、消息拉取失败,对应的去重锁也会在finally阶段被释放,不会影响后续同消息的正常请求
  • 原有的缓存命中判断逻辑可以完整保留,和新增的临时去重锁形成双重校验,覆盖缓存未命中的异步窗口期、缓存已命中两种场景的重复包问题

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 19:24:04