← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.6.1 XXL-JOB:调度中心架构与时间轮设计

审校 2026-09-26 · 素材来源:zcode会话《分析XXL-Job项目架构与集群使用》(项目源码分析)
📑 本篇章节导航 (共6节,点击直达)
场景:一个任务的完整旅程类比:前台 + 排班表 + 时间轮可跑示例:三步起一套原理:调度引擎的双线程设计踩坑清单面试怎么问

半夜两点该跑的对账任务没跑,第二天才发现数据少了半截。谁背锅?你是背 cron 的机器,还是背网络?XXL-JOB 的调度中心就是为了让这类定时任务「准确、可靠、不重复」而生的。这篇拆它的调度内核。

场景:一个任务的完整旅程

XXL-JOB 是一个分布式任务调度平台(多台机器协同管理定时任务的系统)。它分两层:


调度中心 xxl-job-admin(Web 管理台 + 调度引擎,可多节点)
        │ HTTP+JSON 触发任务 / 注册 / 回调
        ▼
执行器 xxl-job-executor(你的业务应用,引入 xxl-job-core 依赖)
        ▼
     数据库 / 业务系统

调度中心拿着排班表(Cron 表达式),到点把活儿派给执行器,执行器干完回来汇报。通信全是 HTTP + JSON,请求头带 XXL-JOB-ACCESS-TOKEN 做鉴权。

类比:前台 + 排班表 + 时间轮

把调度中心想象成一家保洁公司:前台(JobScheduleHelper)每天提前把未来 5 秒的工单从档案柜(MySQL)翻出来,钉在墙上的时钟盘(时间轮)上。秒针每走一格,就取下该格子里的工单派给员工(执行器)。

关键在于:档案柜不用每秒翻一遍,墙上时钟盘查起来极快。

可跑示例:三步起一套


# 1. 官方 docker-compose(自带 MySQL + admin + executor)
cd /path/to/xxl-job/docker && docker-compose up -d

# 2. 访问 {{HOST}}:8080/xxl-job-admin(默认账号 {{DEMO_USER}}/{{ADMIN_PASS}},首次登录必改)
#    在「执行器管理」建分组 appname=my-app

# 3. 业务代码写一个任务处理器

@Component
public class MyJobHandler {
    @XxlJob("myJobHandler")
    public void execute() throws Exception {
        String param = XxlJobHelper.getJobParam();
        XxlJobHelper.log("开始处理, param={}", param);
        // 业务逻辑 ...
        XxlJobHelper.handleSuccess("处理完成");
    }
}

然后在 Web 页面建任务,Cron 填 0 0 2 * * ?,JobHandler 填 myJobHandler,保存。整条链路就通了。

原理:调度引擎的双线程设计

调度中心启动后跑三个后台线程:JobScheduleHelper、JobTriggerPoolHelper、JobRegistryHelper。核心在前两个。

scheduleThread:预读调度线程

每秒对齐执行一次,流程是:

1. 开启 DB 事务,执行 scheduleLock() 拿行锁(SQL 是 SELECT * FROM xxl_job_lock WHERE lock_name='schedule_lock' FOR UPDATE)

2. 查询「下次触发时间 ≤ now+5 秒」的任务

3. 分三种情况:

4. 批量更新任务的 nextTriggerTime,提交事务释放锁

ringThread:时间轮触发线程

同样每秒对齐执行,取出「当前秒 + 前两秒」三个刻度上的 jobId,distinct() 去重后交给 JobTriggerPoolHelper 触发。

为什么要多取前两秒?容忍上一秒的触发稍有延迟,防止漏单;去重则防止单个任务被触发两次。两个细节都体现「宁可多查,绝不重复触发」。

快慢线程池隔离

JobTriggerPoolHelper 维护两个线程池:fastTriggerPool(默认 300 线程)和 slowTriggerPool(默认 200 线程)。统计每个 job 一分钟内超过 500ms 的触发次数,超过 10 次就降级到慢池。一两个慢任务拖不垮整个调度——这是生产稳定性的关键设计。

执行器侧

admin 通过 HTTP 调执行器的 /trigger 接口,进到 ExecutorBizImpl.trigger():按 glueType 找到 JobHandler,处理阻塞策略,把请求塞进该 jobId 独享的 JobThread 队列,执行完由回调线程回报 admin。

任务类型:代码在哪里就触发到哪里

调度中心不执行业务代码,它只负责「到点喊人」。代码有几种存在形态:

这套设计把「调度逻辑」和「业务代码」彻底解耦:admin 升级不影响执行器,执行器发版不影响调度配置。

调度类型的四种姿势

任务什么时候跑,admin 支持四种调度类型:Cron(按表达式,如 0 0 2 * * ? 每天两点)、固定间隔 FixRate(每隔 N 秒跑一次,不管上次跑没跑完)、固定延时 FixDelay(上次执行结束后再等 N 秒)、无 None(不自动跑,靠手动按钮、API 或父子任务触发)。

另外还有父子任务联动:父任务执行成功后自动触发子任务(触发类型 TriggerTypeEnum.PARENT),可以把「取数 → 清洗 → 出报表」串成一条链。

一致性与吞吐的取舍

整条链路里,DB 只承担「拿锁 + 预读 5 秒窗口」的轻量工作,真正的高频触发全在内存时间轮完成。这是典型的读写分离式设计:慢介质保一致性,快介质扛吞吐。

再看 misfire 策略为什么存在:admin 整体宕机五分钟,重启后一批任务的触发时间已经过去。DO_NOTHING 直接跳过(适合日报类,错过就等明天),FIRE_ONCE_NOW 补跑一次(适合对账类,漏一次就资损)。选哪个完全由业务决定,XXL-JOB 只提供开关。

踩坑清单

面试怎么问

「XXL-JOB 调度中心为什么不用每秒扫全表?」——答:预读线程提前把 5 秒内要触发的任务加载进 60 格内存时间轮,触发时只查内存,DB 压力从每秒全表扫降为每秒一次带锁的窗口查询。

「为什么要设计快慢两个触发线程池?」——答:按分钟统计每个任务的触发耗时,超 10 次慢触发的任务路由到慢池,隔离慢任务,防止拖垮正常调度。

「时间轮为什么取当前秒加前两秒?」——答:容忍触发延迟防止漏单,再用 distinct 去重防止重复,宁可多查不可重跑。