`APScheduler` 是 Python 中一个功能强大的定时任务调度库，其核心方法 `add_job` 提供了灵活的参数配置，用于定义任务的执行逻辑、触发条件以及相关属性。 ### 参数说明 - `func`：指定要执行的函数，是必填项。例如 `func=job1` 表示调用 `job1` 函数作为任务体。 - `trigger`：指定任务的触发器，用于定义任务何时执行。常见的触发器包括： - `'interval'`：周期性任务，例如每几秒或几分钟执行一次。 - `'cron'`：基于时间表达式，例如每天上午10点执行。 - `'date'`：仅在指定的时间点执行一次任务。 例如 `trigger='interval'` 或 `trigger='cron'`。 - `args` 和 `kwargs`：指定传递给任务函数的参数。`args` 是位置参数，`kwargs` 是关键字参数。例如 `args=(bane, age)` 表示将 `bane` 和 `age` 作为参数传递给任务函数。 - `id`：为任务指定唯一标识符。在任务管理中，例如修改或移除任务时，可以通过该标识符进行操作。例如 `id='my_job'`。 - `name`：为任务指定一个可读性名称，主要用于日志记录和调试。例如 `name='任务示例'`。 - `misfire_grace_time`：设置任务触发的容忍时间，单位为秒。当任务因调度器暂停而错过触发时，允许任务在延迟一定时间内执行。例如 `misfire_grace_time=60` 表示最多延迟60秒执行。 - `coalesce`：决定是否合并多次触发的任务。当任务被多次触发但无法立即执行时，若设置为 `True`，则仅执行一次任务；若设置为 `False`，则多次执行。例如 `coalesce=True`。 - `max_instances`：定义任务的最大并发实例数，默认为1。例如设置为 `max_instances=3`，允许最多同时运行3个实例。 - `replace_existing`：指定是否替换已存在的任务。若任务 ID 已存在且 `replace_existing=True`，则新任务会覆盖旧任务。例如 `replace_existing=True`。 - `executor`：指定任务执行的执行器。默认情况下，任务由调度器的默认执行器处理，但也可以通过该参数指定特定的执行器。例如 `executor='default_executor'`。 - `jobstore`：指定任务存储的作业存储器。默认情况下，任务存储在默认作业存储器中，但也可以通过该参数指定特定的作业存储器。例如 `jobstore='default'`。 ### 用法示例 以下是一个具体的 `add_job` 使用示例，展示如何配置周期性任务和基于 cron 表达式的任务： ```python from apscheduler.schedulers.background import BackgroundScheduler def job1(name, age): print(f"Job 1 executed with name: {name}, age: {age}") def my_task(): print("This task runs at 10 am every day.") # 初始化调度器 scheduler = BackgroundScheduler() # 添加周期性任务，每30分钟执行一次 scheduler.add_job(func=job1, args=("Alice", 25), trigger="interval", minutes=30, id="my_job", replace_existing=False) # 添加基于 cron 表达式的任务，每天上午10点执行 scheduler.add_job(my_task, trigger='cron', hour=10) # 启动调度器 scheduler.start() # 阻塞主线程以保持调度器运行 try: while True: pass except (KeyboardInterrupt, SystemExit): scheduler.shutdown() ``` ### 注意事项 - **唯一性**：通过 `id` 参数确保任务的唯一性，避免重复添加相同任务。 - **并发控制**：通过 `max_instances` 控制任务的并发实例数，防止资源过度占用。 - **触发器选择**：根据需求选择合适的触发器，例如周期性任务选择 `'interval'`，定时任务选择 `'cron'`。 - **异常处理**：任务执行过程中可能会抛出异常，建议在任务函数中添加异常处理逻辑以确保调度器稳定运行。 ###