XXL-JOB v3.2.0 | 分佈式任務調度平台詳情 - java,任務調度,分佈式 xuxueli 動態日志

Release Notes

1、【強化】AI任務（ollamaJobHandler）優化：針對 “model” 模型配置信息，從執行器側文件類配置調整至調度中心“任務參數”動態配置，支持集成多模型、並結合任務動態配置切換。

2、【安全】登錄認證重構：密碼加密算法從Md5改為Sha256；登錄態改為登錄後動態隨機生成；提升系統安全性；（需要針對用户表進行字段調整，同時需要重新初始化密碼信息；相關SQL腳本如下）

// 1、用户表password字段需要調整長度，執行如下命令
ALTER TABLE xxl_job_user
  MODIFY COLUMN `password` varchar(100) NOT NULL COMMENT '密碼加密信息';
ALTER TABLE xxl_job_user
  ADD COLUMN `token` varchar(100) DEFAULT NULL COMMENT '登錄token';
  
// 2、存量用户密碼需要修改，可執行如下命令將密碼初始化 “123456”；也可以自行通過 “SHA256Tool.sha256” 工具生成其他初始化密碼；
UPDATE xxl_job_user t SET t.password = '8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92' WHERE t.username = {用户名};

3、【強化】GLUE模式(Python) 擴展，支持 "GLUE(Python3)" 與 "GLUE(Python2)" 兩種模式，分別支持 python3/2 多版本；
4、【強化】調度中心繫統日誌調整，支持啓動時指定 -DLOG_HOME 參數自定義日誌位置；同時優化日誌格式提升易讀性；
5、【優化】任務Bean掃描規則調整，過濾冗餘不必要掃描，避免系統組件提前初始化；
6、【優化】登錄信息頁面空值處理優化，避免空值影響ftl渲染；
7、【優化】異常頁面處理邏輯優化，新增兜底落地頁配置；
8、【重構】ReturnT 重構，簡化代碼結構，提升API易用性以及可維護性；
9、【重構】項目結構重構，提升可維護性與易讀性；
10、【修復】漏洞修復（CVE-2025-7787），針對 httpJobHandler 支持配置URL白名單限制，防止服務器端請求偽造（SSRF）攻擊。
11、【修復】合併PR-3738，修復拼寫問題；
12、【修復】合併PR-3506，修復小概率情況下任務重複調度問題；
13、【修復】合併PR-3747，修復異常情況下資源泄漏風險；
14、【修復】IDOR越權問題修復，提升任務操作及日誌管理安全性；
15、【升級】升級多項maven依賴至較新版本，如 netty、groovy、mybatis、spring、spring-ai、dify 等；

“AI任務”接入示例

此處以 difyWorkflowJobHandler 為例，注意需要前置部署AI執行器（xxl-job-executor-sample-ai），可參考官方文檔説明。

步驟一：調度中心，新建 difyWorkflowJobHandler 任務

在這裏插入圖片描述

步驟二：任務執行，查看任務進度及日誌

在這裏插入圖片描述

“常規任務”接入示例

XXL-JOB支持多模式任務，下文以簡單的“Bean模式任務”為例介紹，三步快速開發接入。

步驟一：執行器，開發Job方法

@XxlJob("demoJobHandler")
 public void demoJobHandler() throws Exception {
    XxlJobHelper.log("XXL-JOB, Hello World.");
}

步驟二：調度中心，新建調度任務

步驟三：任務執行，查看任務進度及日誌

簡介

XXL-JOB是一個輕量級分佈式任務調度平台，其核心設計目標是開發迅速、學習簡單、輕量級、易擴展。現已開放源代碼並接入多家公司線上產品線，開箱即用。

中文文檔：http://www.xuxueli.com/xxl-job/
社區交流：http://www.xuxueli.com/page/community.html

特性

1、簡單：支持通過Web頁面對任務進行CRUD操作，操作簡單，一分鐘上手；
2、動態：支持動態修改任務狀態、啓動/停止任務，以及終止運行中任務，即時生效；
3、調度中心HA（中心式）：調度採用中心式設計，“調度中心”自研調度組件並支持集羣部署，可保證調度中心HA；
4、執行器HA（分佈式）：任務分佈式執行，任務"執行器"支持集羣部署，可保證任務執行HA；
5、註冊中心: 執行器會週期性自動註冊任務, 調度中心將會自動發現註冊的任務並觸發執行。同時，也支持手動錄入執行器地址；
6、彈性擴容縮容：一旦有新執行器機器上線或者下線，下次調度時將會重新分配任務；
7、觸發策略：提供豐富的任務觸發策略，包括：Cron觸發、固定間隔觸發、固定延時觸發、API（事件）觸發、人工觸發、父子任務觸發；
8、調度過期策略：調度中心錯過調度時間的補償處理策略，包括：忽略、立即補償觸發一次等；
9、阻塞處理策略：調度過於密集執行器來不及處理時的處理策略，策略包括：單機串行（默認）、丟棄後續調度、覆蓋之前調度；
10、任務超時控制：支持自定義任務超時時間，任務運行超時將會主動中斷任務；
11、任務失敗重試：支持自定義任務失敗重試次數，當任務失敗時將會按照預設的失敗重試次數主動進行重試；其中分片任務支持分片粒度的失敗重試；
12、任務失敗告警；默認提供郵件方式失敗告警，同時預留擴展接口，可方便的擴展短信、釘釘等告警方式；
13、路由策略：執行器集羣部署時提供豐富的路由策略，包括：第一個、最後一個、輪詢、隨機、一致性HASH、最不經常使用、最近最久未使用、故障轉移、忙碌轉移等；
14、分片廣播任務：執行器集羣部署時，任務路由策略選擇"分片廣播"情況下，一次任務調度將會廣播觸發集羣中所有執行器執行一次任務，可根據分片參數開發分片任務；
15、動態分片：分片廣播任務以執行器為維度進行分片，支持動態擴容執行器集羣從而動態增加分片數量，協同進行業務處理；在進行大數據量業務操作時可顯著提升任務處理能力和速度。
16、故障轉移：任務路由策略選擇"故障轉移"情況下，如果執行器集羣中某一台機器故障，將會自動Failover切換到一台正常的執行器發送調度請求。
17、任務進度監控：支持實時監控任務進度；
18、Rolling實時日誌：支持在線查看調度結果，並且支持以Rolling方式實時查看執行器輸出的完整的執行日誌；
19、GLUE：提供Web IDE，支持在線開發任務邏輯代碼，動態發佈，實時編譯生效，省略部署上線的過程。支持30個版本的歷史版本回溯。
20、腳本任務：支持以GLUE模式開發和運行腳本任務，包括Shell、Python、NodeJS、PHP、PowerShell等類型腳本;
21、命令行任務：原生提供通用命令行任務Handler（Bean任務，"CommandJobHandler"）；業務方只需要提供命令行即可；
22、任務依賴：支持配置子任務依賴，當父任務執行結束且執行成功後將會主動觸發一次子任務的執行, 多個子任務用逗號分隔；
23、一致性：“調度中心”通過DB鎖保證集羣分佈式調度的一致性, 一次任務調度只會觸發一次執行；
24、自定義任務參數：支持在線配置調度任務入參，即時生效；
25、調度線程池：調度系統多線程觸發調度運行，確保調度精確執行，不被堵塞；
26、數據加密：調度中心和執行器之間的通訊進行數據加密，提升調度信息安全性；
27、郵件報警：任務失敗時支持郵件報警，支持配置多郵件地址羣發報警郵件；
28、推送maven中央倉庫: 將會把最新穩定版推送到maven中央倉庫, 方便用户接入和使用;
29、運行報表：支持實時查看運行數據，如任務數量、調度次數、執行器數量等；以及調度報表，如調度日期分佈圖，調度成功分佈圖等；
30、全異步：任務調度流程全異步化設計實現，如異步調度、異步運行、異步回調等，有效對密集調度進行流量削峯，理論上支持任意時長任務的運行；
31、跨語言/OpenAPI：調度中心與執行器提供語言無關的 OpenApi（RESTful 格式），第三方任意語言可據此對接調度中心或者實現執行器，實現多語言支持。除此之外，還提供了 “多任務模式”和“httpJobHandler”等其他跨語言方案；
32、國際化：調度中心支持國際化設置，提供中文、英文兩種可選語言，默認為中文；
33、容器化：提供官方docker鏡像，並實時更新推送dockerhub，進一步實現產品開箱即用；
34、線程池隔離：調度線程池進行隔離拆分，慢任務自動降級進入"Slow"線程池，避免耗盡調度線程，提高系統穩定性；
35、用户管理：支持在線管理系統用户，存在管理員、普通用户兩種角色；
36、權限控制：執行器維度進行權限控制，管理員擁有全量權限，普通用户需要分配執行器權限後才允許相關操作；
37、AI任務：原生提供AI執行器，並內置多個AI任務Handler，與spring-ai、ollama、dify等集成打通，支持快速開發AI類任務。