终极指南：Quartz与XXL-Job定时任务实战教程，轻松掌握分布式调度核心技能

终极指南：Quartz与XXL-Job定时任务实战教程，轻松掌握分布式调度核心技能

【免费下载链接】CodeGuide:books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助，请给予支持(关注、点赞、分享)！项目地址: https://gitcode.com/gh_mirrors/code/CodeGuide

GitHub 加速计划 / code / CodeGuide 项目提供了全面的 Java 学习教程，其中定时任务模块涵盖了 Quartz、Spring-Schedule 和 XXL-Job 等主流任务调度技术。本文将带你快速掌握这些工具的使用方法，帮助你在项目中灵活选择合适的定时任务解决方案。

为什么需要定时任务调度？

在日常开发中，定时任务是不可或缺的组件，广泛应用于各种场景：

• 数据清理：定时清理日志、迁移冷数据
• 业务监控：活动状态扫描、过期活动自动关闭
• 消息补偿：MQ 消息发送失败重试
• 支付处理：支付掉单补偿、T+n 账单结算

如图所示，在 DDD 分层架构中，定时任务通常作为触发器层的一部分，调用领域层的业务逻辑。根据项目规模和需求，可以选择不同的任务调度方案：简单场景使用 Quartz 或 Spring-Schedule，复杂分布式场景则适合 XXL-Job。

Quartz：轻量级定时任务解决方案

Quartz 是一个功能强大的开源定时任务框架，具有以下特点：

• 支持复杂的 cron 表达式调度
• 提供丰富的任务管理 API
• 支持集群部署
• 灵活的线程池配置

快速上手 Quartz

1. 引入依赖

<dependency> <groupId>org.quartz-scheduler</groupId> <artifactId>quartz</artifactId> <version>2.3.2</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-quartz</artifactId> <version>3.1.2</version> </dependency>

2. 创建任务类

@Slf4j @Component public class QuartzJob { @Scheduled(cron = "0/3 * * * * ?") public void execute01() { log.info("执行任务 - Quartz - 01"); } @Scheduled(cron = "0/3 * * * * ?") public void execute02() { log.info("执行任务 - Quartz - 02"); } }

3. 配置说明

Quartz 提供了默认配置文件quartz.properties，你可以根据需要调整：

# 默认线程池大小 org.quartz.threadPool.threadCount: 10 # 任务存储方式，默认为内存存储 org.quartz.jobStore.class: org.quartz.simpl.RAMJobStore

当任务较多时，可以通过增加线程池大小来提高并发处理能力。

XXL-Job：分布式任务调度平台

XXL-Job 是一个分布式任务调度平台，具有以下优势：

• 提供可视化的任务管理界面
• 支持任务失败重试、任务依赖
• 动态调整任务频率
• 完善的监控和报警机制
• 易于扩展的执行器集群

XXL-Job 架构

XXL-Job 采用中心化调度+分布式执行的架构：

• 调度中心：负责任务管理、触发调度
• 执行器：注册到调度中心，接收并执行任务
• RPC：执行器通过 RPC 调用微服务接口

快速部署 XXL-Job

使用 Docker Compose 快速部署 XXL-Job：

version: '3.9' services: xxl-job-admin: image: kuschzzp/xxl-job-aarch64:2.4.0 container_name: xxl-job-admin restart: always depends_on: - mysql ports: - "9090:9090" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/xxl_job?serverTimezone=UTC&characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=root - SPRING_DATASOURCE_PASSWORD=123456 - SERVER_PORT=9090 mysql: image: mysql:8.0.32 container_name: mysql restart: always environment: MYSQL_ROOT_PASSWORD: 123456 ports: - "13306:3306" volumes: - ./sql:/docker-entrypoint-initdb.d

执行命令启动：docker-compose up -d

开发 XXL-Job 任务

1. 引入依赖

<dependency> <groupId>com.xuxueli</groupId> <artifactId>xxl-job-core</artifactId> <version>2.4.0</version> </dependency>

2. 配置执行器

xxl: job: accessToken: default_token admin: addresses: http://localhost:9090/xxl-job-admin executor: appname: xxl-job-executor-sample port: 9999

3. 创建任务

@Slf4j @Component public class XXLJob { @XxlJob("demoJobHandler") public void doJob() { log.info("执行任务 - XXL-Job - 01"); } }

4. 在调度中心配置任务

访问 XXL-Job 管理界面http://127.0.0.1:9090/xxl-job-admin，使用默认账号admin/123456登录，配置任务执行器和调度规则。

如何选择合适的定时任务方案？

• 小型项目：优先选择 Quartz，配置简单，无需额外部署
• 分布式系统：推荐使用 XXL-Job，提供更完善的任务管理和监控
• 高可用需求：XXL-Job 提供更好的故障转移和负载均衡能力

实战经验分享

1. 任务频率设置：避免使用过于密集的调度频率，防止系统负载过高
2. 任务幂等性：确保任务可以重复执行，使用唯一标识避免重复处理
3. 任务超时控制：设置合理的任务超时时间，避免任务阻塞
4. 日志记录：详细记录任务执行日志，便于问题排查
5. 监控报警：对关键任务配置监控和报警，及时发现异常

总结

定时任务是后端开发不可或缺的技能，Quartz 和 XXL-Job 是两个非常优秀的解决方案。通过本文的介绍，你应该已经掌握了它们的基本使用方法和适用场景。

在实际项目中，需要根据项目规模、团队技术栈和业务需求选择合适的方案。对于简单场景，Quartz 足够满足需求；对于复杂的分布式系统，XXL-Job 提供了更强大的功能和更好的可维护性。

希望本文对你有所帮助，更多关于定时任务的高级用法和源码解析，可以参考项目中的详细文档：docs/md/spring/source-code/2020-01-01-[源码解析]Spring定时任务Quartz执行全过程源码解读.md 和 docs/md/road-map/quartz.md。

祝你在定时任务的学习和实践中取得进步！🚀

【免费下载链接】CodeGuide:books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助，请给予支持(关注、点赞、分享)！项目地址: https://gitcode.com/gh_mirrors/code/CodeGuide