如何让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
相关产品推荐
相关产品推荐

