You need to enable JavaScript to run this app. Python版Bot Framework如何实现每日9点定时触发主动消息推送
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.06 12:06:03