Python版Bot Framework如何实现每日9点定时触发主动消息推送
报错根因
- 直接触发警告的原因:你把
async定义的schedule_event函数直接塞给了普通线程当执行目标。普通线程根本不认识async协程,只会拿到一个协程对象直接返回,根本不会执行内部的await逻辑,自然就抛coroutine 'schedule_event' was never awaited的警告。 - 方案本身的适配问题:你用的
schedule是纯同步的定时库,就算你解决了协程执行的问题,它也没法正确调用异步的发送函数,还是会出问题。 - 架构层面的隐藏问题:Bot框架里发主动消息用到的客户端、会话上下文全是绑定在Bot服务主asyncio事件循环上的,你在独立普通线程里搞一套执行环境,和主服务的上下文根本不通,就算能跑起来,发消息也会失败。
正确实现方案
别再用普通线程+同步schedule的组合了,直接用和asyncio生态适配的异步调度器,和Bot服务跑在同一个事件循环上,省得处理跨线程的兼容问题:
- 先安装依赖:执行
pip install apscheduler,这个库的异步版本完全适配当前Bot使用的aiohttp Web服务运行环境 - 直接复用原示例已经实现的能力:原示例里存储所有可推送用户会话引用(ConversationReference)的逻辑不用改,所有和Bot交互过、有权限接收主动消息的用户,本来就存在全局字典里
- 核心代码直接替换你原来的线程启动部分即可,参考结构如下:
import asyncio from apscheduler.schedulers.asyncio import AsyncIOScheduler # 原示例已实现的全局存储:key为用户ID,value为对应用户的ConversationReference conversation_ref_store = {} async def batch_send_daily_notification(): # 原示例已实现的单用户主动消息发送逻辑,遍历存储的会话引用批量发送即可 for user_ref in conversation_ref_store.values(): await _send_proactive_message(user_ref) if __name__ == "__main__": try: # 初始化和主事件循环绑定的异步调度器 scheduler = AsyncIOScheduler() # 正式上线配置:每日早9点触发 scheduler.add_job( batch_send_daily_notification, trigger="cron", hour=9, # 临时验证配置:每10秒触发一次,验证完成后删除 # trigger="interval", # seconds=10 ) scheduler.start() # 正常启动Bot Web服务 web.run_app(APP, host="localhost", port=CONFIG.PORT) except Exception as error: raise error
落地注意事项
- 这套方案所有定时任务的触发、消息发送逻辑全跑在Bot的主事件循环上,协程会被正常执行,完全不会出现之前的RuntimeWarning
- 临时验证阶段直接替换配置为10秒间隔触发即可,验证逻辑通顺后切回每日9点的cron规则
- 如果你一定要坚持开独立线程跑定时任务,绝对不能在线程里直接await异步函数,必须拿到主事件循环的全局引用,通过
asyncio.run_coroutine_threadsafe()把发送任务投递到主循环里执行,不然跨线程调用Bot客户端发消息一定会报错 - 主动消息只能发给已经被存储了会话引用的用户,没有交互过的用户拿不到有效调用上下文,就算定时任务触发了也无法完成推送。
内容的提问来源于stack exchange,提问作者Gabriele Pisapia
相关产品推荐
相关产品推荐

