You need to enable JavaScript to run this app. discord.py中client.wait_for设低于1秒超时无法正常监听reaction_add问题
优惠活动
大模型
产品
解决方案
定价
更多

discord.py中client.wait_for设低于1秒超时无法正常监听reaction_add问题

问题原因

这个问题由Discord网关推送延迟和discord.py事件调度机制共同导致,和你的操作反应速度、循环逻辑没有关系:

  • Discord客户端的表情点击事件需要先上传到Discord服务器,再通过网关推送到你的Bot端,这个过程本身就有200~600ms的波动延迟,再叠加discord.py内部事件队列的调度开销,很容易出现事件还没推送到Bot端,0.75秒的超时就已经结束的情况,所以会识别不到单次点击。
  • 双击表情能触发的本质是:第一次点击的事件刚好在超时结束后才推送到Bot端,第二次点击的事件刚好落在下一轮循环的监听窗口内,所以会误判为只有双击生效。

解决方案

1. 用全局事件缓存替代原生wait_for

原生wait_for只会监听调用之后产生的事件,无法覆盖调用前已经在传输路上的事件,你可以用全局缓存提前接收所有反应事件,抵消网关延迟的影响,示例实现如下:

import asyncio
import time

# 全局缓存队列,存储最近1秒内收到的反应事件
recent_reactions = asyncio.Queue(maxsize=100)

# 全局监听所有反应事件提前存入缓存
@client.event
async def on_reaction_add(reaction, user):
    if user.bot:
        return
    await recent_reactions.put( (user.id, reaction.message.id, str(reaction.emoji), time.time()) )

# 自定义短超时监听方法,替代原生wait_for
async def fast_reaction_listen(target_user_id, target_msg_id, allowed_emojis, timeout):
    start_time = time.time()
    # 先检查缓存中已收到的符合条件的事件
    while not recent_reactions.empty():
        item = recent_reactions.get_nowait()
        uid, msg_id, emoji, ts = item
        # 跳过超过1秒的过期事件
        if time.time() - ts > 1:
            continue
        if uid == target_user_id and msg_id == target_msg_id and emoji in allowed_emojis:
            return (emoji, ts)
        # 不符合条件的事件塞回队列
        await recent_reactions.put(item)
    # 监听新事件,按你要求的超时时间终止
    while time.time() - start_time < timeout:
        try:
            # 每100ms轮询一次,避免计时误差
            item = await asyncio.wait_for(recent_reactions.get(), timeout=0.1)
            uid, msg_id, emoji, ts = item
            if uid == target_user_id and msg_id == target_msg_id and emoji in allowed_emojis:
                return (emoji, ts)
            await recent_reactions.put(item)
        except asyncio.TimeoutError:
            continue
    # 超时抛出异常,和原生wait_for行为对齐
    raise asyncio.TimeoutError

2. 优化Bot配置降低延迟

  • 初始化Client时关闭不需要的意图(比如presences、members等),减少无关事件的调度开销,降低内部队列延迟。
  • 尽量将Bot部署在靠近Discord API节点的区域(比如美西),可以把网关推送延迟压到200ms以内,配合上述缓存方案可以稳定支持0.5秒级别的超时监听。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.19 21:45:10