如何使用 TeleBot 实现定时单次消息发送（如出发前24小时提醒）-Python教程-PHP中文网

本文介绍基于 python telebot 库实现精确到秒的单次定时消息推送方案，通过后台线程轮询当前时间，匹配预设触发条件后仅发送一次提醒，适用于航班/行程出发前1天等典型场景。

本文介绍基于 python telebot 库实现精确到秒的单次定时消息推送方案，通过后台线程轮询当前时间，匹配预设触发条件后仅发送一次提醒，适用于航班/行程出发前1天等典型场景。

在使用 pyTelegramBotAPI（即 telebot）开发 Telegram 机器人时，若需实现「仅在特定时刻发送一条提醒消息」（例如：用户出发日期为 2025-04-15 08:30，则在 2025-04-14 08:30 精准发送一次出发提醒），不能依赖传统周期性调度器（如 schedule）的 .every().day.at() 等方式——因为它们本质是循环触发，无法原生支持“未来某刻仅执行一次”的语义，且难以动态管理长期（如跨月）任务。

✅ 正确思路是：启动一个轻量级后台线程，持续检查系统时间，当满足用户设定的唯一触发时间点时，调用 bot.send_message() 发送消息，并立即移除或跳过该任务，确保仅执行一次。

以下是一个生产就绪的参考实现：

Sakura python draw

使用Python的turtle和random库，递归绘制分形樱花树，并动画模拟花瓣自然飘落效果。

下载

import telebot
import time
import datetime
import threading

bot = telebot.TeleBot("YOUR_BOT_TOKEN_HERE")
chat_id = None
departure_time = None  # 格式：datetime.datetime(2025, 4, 14, 8, 30) —— 出发前1天的提醒时刻

def run_scheduler():
    global departure_time, chat_id
    sent = False  # 标志位：是否已发送

    while True:
        now = datetime.datetime.now()

        # ✅ 关键逻辑：仅当未发送 + 当前时间 ≥ 目标时间 + 秒级精度对齐时触发
        if not sent and departure_time and now >= departure_time:
            try:
                bot.send_message(chat_id, "⏰ 提醒：您明天上午8:30出发，请提前做好准备！")
                sent = True  # 锁定，后续轮询不再触发
                print(f"[INFO] Message sent at {now}")
            except Exception as e:
                print(f"[ERROR] Failed to send message: {e}")

        time.sleep(1)  # 每秒检查一次，低开销且足够精准

# 用户通过 /setremind <yyyy-mm-dd hh:mm> 设置出发提醒（示例）
@bot.message_handler(commands=['setremind'])
def handle_set_remind(message):
    global chat_id, departure_time
    chat_id = message.chat.id
    try:
        # 解析用户输入：/setremind 2025-04-15 08:30
        cmd_parts = message.text.strip().split()
        if len(cmd_parts) != 3:
            raise ValueError("格式错误：请使用 /setremind YYYY-MM-DD HH:MM")

        date_str, time_str = cmd_parts[1], cmd_parts[2]
        dt = datetime.datetime.strptime(f"{date_str} {time_str}", "%Y-%m-%d %H:%M")
        departure_time = dt - datetime.timedelta(days=1)  # 提前24小时提醒

        bot.reply_to(message, f"✅ 已设置出发提醒：{dt.strftime('%Y-%m-%d %H:%M')} → 提醒时间为 {departure_time.strftime('%Y-%m-%d %H:%M')}")
    except ValueError as e:
        bot.reply_to(message, f"❌ 输入格式错误：{e}，示例：/setremind 2025-04-15 08:30")

# 启动调度线程（非阻塞）
scheduler_thread = threading.Thread(target=run_scheduler, daemon=True)
scheduler_thread.start()

bot.polling(none_stop=True)</yyyy-mm-dd>

? 关键设计说明：