企业微信 API 开发：定时任务如何避免重复执行？

在开发企业微信自动化功能时，经常需要定时执行一些任务，比如同步群信息、检查消息发送状态、处理待发送的业务通知。

如果定时任务执行时间过长，或者服务部署了多个实例，就可能出现同一个任务被执行多次的情况。

一、为什么定时任务会重复执行？

常见原因主要有三个：

执行时间过长：上一轮任务还没结束，下一轮已经开始。
多实例部署：多个服务实例同时启动定时任务，各自执行了一遍。
服务重启：任务执行到一半发生异常，恢复后又从头执行。

因此，不能只依赖定时器本身，还需要控制任务的执行状态。

二、单实例怎么处理？

如果服务只有一个实例，可以先使用互斥锁，确保同一时间只有一个任务在执行。

复制代码

import threading

task_lock = threading.Lock()

def sync_group_task():
    if not task_lock.acquire(blocking=False):
        print("上一轮任务尚未结束")
        return

    try:
        # 执行群信息同步逻辑
        print("开始同步群信息")
    finally:
        task_lock.release()

这里使用 threading.Lock() 防止当前 Python 进程内的任务重叠执行。

需要注意，这种方式只对当前进程有效。如果部署了多个实例，每个实例都有自己的锁，仍然可能同时执行任务。

三、多实例部署怎么办？

如果任务由多个服务实例共同执行，可以考虑使用数据库任务表或分布式锁。

例如，使用数据库任务表时，可以为任务设置以下状态：

状态	含义
pending	等待执行
running	正在执行
success	执行成功
failed	执行失败

任务启动前，先通过数据库事务或原子更新抢占任务。只有成功取得执行权的实例才能继续处理。

如果使用分布式锁，还需要设置合理的过期时间，并考虑任务执行超过锁有效期的情况。对于重要业务，可以增加执行令牌或版本号，避免旧任务在失去执行权后继续修改数据。

四、失败后如何恢复？

任务执行失败时，不建议直接删除记录或无限重试。

可以采用以下策略：

记录错误原因和失败时间。
根据错误类型判断是否允许重试。
设置最大重试次数和重试间隔。
超过限制后进入异常队列，等待人工检查。

对于群信息同步这类任务，还可以保存上次成功执行的时间，方便下次从合适的位置继续处理。

五、实际开发建议

企业微信 API 的定时同步、消息状态检查等功能，可以根据任务重要程度选择不同方案：简单的单实例任务使用进程锁，多实例任务使用数据库原子操作或分布式锁。