用途:APScheduler 为 Python 应用提供灵活的任务调度与作业队列能力,支持同步和异步执行,适合定时任务、周期任务和一次性任务,也可用于 FastAPI 等框架的后台任务。
主要能力:提供多种调度器,包括内存调度器(开发用,重启后作业丢失)、持久化调度器(生产用,作业可跨重启保留)和分布式调度器(通过角色区分调度节点与工作节点)。触发器类型包括 IntervalTrigger(间隔)、CronTrigger(cron 式,支持 day_of_week、*/15 等表达式及 from_crontab)、DateTrigger(一次性)和 CalendarIntervalTrigger(日历间隔)。作业支持同步函数、异步协程、位置参数与关键字参数。
持久化与事件:可通过 SQLAlchemyDataStore 对接 SQLite、PostgreSQL、MongoDB 等后端,使用 AsyncpgEventBroker、RedisEventBroker 等事件代理实现分布式通信。提供作业结果获取、调度暂停/恢复/移除/查询、事件订阅(如 JobAdded、JobReleased)等管理接口。
使用方式:内存调度器示例如 with Scheduler() as scheduler: scheduler.add_schedule(tick, IntervalTrigger(seconds=1));scheduler.run_until_stopped()。异步持久化示例先创建引擎并构造 SQLAlchemyDataStore,再传入 AsyncScheduler。安装命令:uv add apscheduler,按需加扩展,如 uv add "apscheduler[postgresql]"、uv add "apscheduler[sqlite]"、uv add "apscheduler[redis]"。
限制与建议:生产环境应使用持久化存储以跨重启保留作业;设置合适的 misfire_grace_time 处理延迟;更新调度时注意冲突策略;订阅事件便于监控调试;按 I/O 或 CPU 特性选择 threadpool 或 processpool 执行器;为作业函数加入错误处理;使用唯一调度 ID;设置结果过期时间以防内存泄漏。资料未提供具体收费、版本或性能指标。