架构与系统设计 / 系统课时
定时任务分租户执行
定时任务分租户执行
定时任务一旦直接遍历全部租户,容易出现重复执行、单租户阻塞全局和多节点并发冲突。本课给出一条可落地的执行链路:分页扫描租户、稳定分片、租户级加锁、业务幂等、失败重试,并说明如何验收。
学习目标
- 设计可横向扩容的租户扫描与分片规则
- 使用租户级锁和幂等键阻止重复处理
- 建立失败记录、退避重试和人工补偿边界
为什么不能全租户一把跑完
把所有租户放进一个大事务或一把全局锁,会让慢租户拖住其他租户;任务节点扩容后,还可能同时处理同一租户。正确做法是把“调度触发”和“租户执行”拆开:调度器只负责发现任务,执行器按租户形成独立处理单元。

执行链路与关键规则
租户扫描应按主键游标分页,例如每次读取 200 个启用租户,避免一次性加载全部数据。分片公式可以固定为 floorMod(hash(tenantId), workerCount),同一轮任务中 workerCount 必须稳定,否则租户会在节点间漂移。
执行前先获取 taskCode:tenantId 维度的短租约锁,锁只用于抑制并发,不替代幂等。真正的幂等键应包含业务周期,例如 daily-settlement:2026-08-03:1002,并通过数据库唯一约束保证即使锁失效也不会重复入账。
失败重试要保存租户、任务编码、业务日期、重试次数和最后错误。瞬时错误采用指数退避;参数错误、数据缺失等永久错误直接进入人工补偿,避免无意义地反复执行。
可运行的分片与幂等示例
下面的 Java 17 示例用内存集合模拟分片、锁、幂等和一次失败重试。生产环境应把锁替换为 Redis 或数据库租约,把幂等集合替换为带唯一键的任务执行表。
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);
}
}
}
}预期输出:
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 次,并记录下一次执行时间。节点崩溃后,租约锁应自动过期;任务恢复时先查询幂等记录,再决定继续、跳过或补偿,不能仅凭“锁是否存在”判断业务是否完成。
验收时至少覆盖:两个节点同时触发同一任务、执行中节点宕机、同一业务日期重复补跑、单租户持续失败以及租户处理中途被停用。最终应满足“其他租户不受阻、成功结果不重复、失败可追踪可补偿”。
本课总结
- 调度器负责发现租户,执行器按稳定分片独立处理租户
- 分布式锁抑制并发,数据库幂等键保证最终不重复
- 重试必须区分瞬时与永久错误,并保留人工补偿入口
下一课预告
下一课将继续处理租户边界,把文件对象、访问签名和搜索索引纳入同一套隔离规则。