架构与系统设计 / 系统课时

定时任务分租户执行

定时任务分租户执行

定时任务一旦直接遍历全部租户,容易出现重复执行、单租户阻塞全局和多节点并发冲突。本课给出一条可落地的执行链路:分页扫描租户、稳定分片、租户级加锁、业务幂等、失败重试,并说明如何验收。

学习目标

  • 设计可横向扩容的租户扫描与分片规则
  • 使用租户级锁和幂等键阻止重复处理
  • 建立失败记录、退避重试和人工补偿边界

为什么不能全租户一把跑完

把所有租户放进一个大事务或一把全局锁,会让慢租户拖住其他租户;任务节点扩容后,还可能同时处理同一租户。正确做法是把“调度触发”和“租户执行”拆开:调度器只负责发现任务,执行器按租户形成独立处理单元。

定时任务按租户执行流程

执行链路与关键规则

租户扫描应按主键游标分页,例如每次读取 200 个启用租户,避免一次性加载全部数据。分片公式可以固定为 floorMod(hash(tenantId), workerCount),同一轮任务中 workerCount 必须稳定,否则租户会在节点间漂移。

执行前先获取 taskCode:tenantId 维度的短租约锁,锁只用于抑制并发,不替代幂等。真正的幂等键应包含业务周期,例如 daily-settlement:2026-08-03:1002,并通过数据库唯一约束保证即使锁失效也不会重复入账。

失败重试要保存租户、任务编码、业务日期、重试次数和最后错误。瞬时错误采用指数退避;参数错误、数据缺失等永久错误直接进入人工补偿,避免无意义地反复执行。

可运行的分片与幂等示例

下面的 Java 17 示例用内存集合模拟分片、锁、幂等和一次失败重试。生产环境应把锁替换为 Redis 或数据库租约,把幂等集合替换为带唯一键的任务执行表。

java
import java.util.List;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;

public class TenantJobDemo {
    private static final Set<Long> LOCKS = ConcurrentHashMap.newKeySet();
    private static final Set<String> DONE_KEYS = ConcurrentHashMap.newKeySet();

    public static void main(String[] args) {
        List<Long> tenantIds = List.of(1001L, 1002L, 1003L);
        runWorker(tenantIds, 0, 2, "daily-report", "2026-08-03");
        runWorker(List.of(1002L), 0, 2, "daily-report", "2026-08-03");
    }

    private static void runWorker(List<Long> tenantIds, int workerIndex,
                                  int workerCount, String taskCode, String bizDate) {
        for (long tenantId : tenantIds) {
            int shard = Math.floorMod(Long.hashCode(tenantId), workerCount);
            if (shard != workerIndex) {
                System.out.printf("SKIP tenant=%d shard=%d%n", tenantId, shard);
                continue;
            }

            String doneKey = taskCode + ":" + bizDate + ":" + tenantId;
            if (DONE_KEYS.contains(doneKey)) {
                System.out.printf("SKIP tenant=%d idempotent=true%n", tenantId);
                continue;
            }

            if (!LOCKS.add(tenantId)) {
                System.out.printf("SKIP tenant=%d locked=true%n", tenantId);
                continue;
            }

            try {
                for (int attempt = 1; attempt <= 2; attempt++) {
                    System.out.printf("RUN tenant=%d attempt=%d%n", tenantId, attempt);
                    if (attempt == 1) {
                        System.out.printf("RETRY tenant=%d%n", tenantId);
                        continue;
                    }
                    DONE_KEYS.add(doneKey);
                    System.out.printf("DONE tenant=%d%n", tenantId);
                    break;
                }
            } finally {
                LOCKS.remove(tenantId);
            }
        }
    }
}

预期输出:

text
SKIP tenant=1001 shard=1
RUN tenant=1002 attempt=1
RETRY tenant=1002
RUN tenant=1002 attempt=2
DONE tenant=1002
SKIP tenant=1003 shard=1
SKIP tenant=1002 idempotent=true

实际生产日志中的时间、节点名和任务实例 ID 会不同,但同一幂等键只能出现一次成功记录。

失败重试与验收

重试次数通常控制在 3~5 次,并记录下一次执行时间。节点崩溃后,租约锁应自动过期;任务恢复时先查询幂等记录,再决定继续、跳过或补偿,不能仅凭“锁是否存在”判断业务是否完成。

验收时至少覆盖:两个节点同时触发同一任务、执行中节点宕机、同一业务日期重复补跑、单租户持续失败以及租户处理中途被停用。最终应满足“其他租户不受阻、成功结果不重复、失败可追踪可补偿”。

本课总结

  • 调度器负责发现租户,执行器按稳定分片独立处理租户
  • 分布式锁抑制并发,数据库幂等键保证最终不重复
  • 重试必须区分瞬时与永久错误,并保留人工补偿入口

下一课预告

下一课将继续处理租户边界,把文件对象、访问签名和搜索索引纳入同一套隔离规则。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定时任务分租户执行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通