XXL-JOB v3.3.2 宣布 | 优雅停机、Docker Compose、结实性加强

应用介绍

Docker Compose启动步调：

// 下载 XXL-JOBgit clone --branch "$(curl -s https://api.github.com/repos/xuxueli/xxl-job/releases/latest | jq -r .tag_name)" https://github.com/xuxueli/xxl-job.git// 构建 XXL-JOBmvn clean package -Dmaven.test.skip=true// 启动 XXL-JOBMYSQL_PATH={自定义数据库持久化目次} docker compose up -d// 停止 XXL-JOBdocker compose down

• 3、【优化】调剂中间操作体验优化：表格交互调剂为单行选中模式；禁用分页轮回；优化分页限制案牍；
• 4、【优化】调剂线程事务提交逻辑调剂，避免界线前提下线程异常退出，加强结实性；
• 5、【优化】调剂日记列表排序逻辑优化，晋升易读性；
• 6、【优化】调剂中间OpenAPI通信token调剂为非必填；归并PR-3892；
• 7、【优化】履行器详情接口权限调剂，支撑通俗用户查看注册节点；归并PR-3882；
• 8、【优化】义务参数LogDateTime生成逻辑调剂，分片广播场景下保障同一批调剂一致；
• 9、【进级】进级多项maven依附至较新版本，如 spring、netty、xxl-sso、xxl-tool 等；
• 10、【优化】同一项目依附治理构造，依附版本同一到父级pom晋升可保护性；

义务开辟示例

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

步调二：调剂中间，新建调剂义务

步调三：义务履行，查看义务进度及日记

简介

XXL-JOB支撑多模式义务，下文以简单的“Bean模式义务”为例介绍，三步快速开辟接入。

步调一：履行器，开辟Job办法

XXL-JOB是一个轻量级分布式义务调剂平台，其核心设计目标是开辟敏捷、进修简单、轻量级、易扩大。现已开放源代码并接入多家公司线上产品线，开箱即用。

• 中文文档：http://www.xuxueli.com/xxl-job/
• 社区交换：http://www.xuxueli.com/page/community.html

XXL-JOB 正在比赛 “2025 年度Gitee最受迎接的开源软件”，等待您投出宝贵一票，你的承认对我们很重要🌹～

• 投票链接👉：https://gitee.com/activity/2025opensource?ident=ISLBOH

Release Notes

• 1、【优化】优雅停机：调剂中间停机，检测时光轮非空时主动等待调剂完成；客户端停机，检测存在运行中义务时，停止接收新义务并主动等待义务履行完成；
• 2、【新增】新增 Docker Compose 设备，支撑一键设备启动调剂中间集群；

特点

• 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类义务。
• 38、审计日记：记录义务操作敏感信息，用于体系监控、审计和安然分析，可快速追溯异常行动以及定位排盘考题。
• 39、优雅停机：调剂中间停机，检测时光轮非空时主动等待调剂完成；客户端停机，检测存在运行中义务时，停止接收新义务并主动等待义务履行完成；