XXL-JOB

### XXL-Job 分布式任务调度平台使用指南 XXL-JOB 是一个轻量级的分布式任务调度框架，由大众点评员工徐雪里于2015年发布[^1]。其核心设计目标是开发迅速、学习简单、轻量级和易扩展。以下是关于 XXL-JOB 的安装、配置及使用方法的详细指南。 --- #### 1. 下载与安装 XXL-JOB 提供了管理后台和执行器两个部分。需要分别下载并配置它们。 - **下载地址**: 官方地址为 [https://www.xuxueli.com/xxl-job/](https://www.xuxueli.com/xxl-job/)。 - **步骤**: - 下载 XXL-JOB 源码或二进制包。 - 确保本地已安装 JDK (推荐版本为 1.8 或以上) 和 Maven。 - 构建项目：运行以下命令以生成可执行文件。 ```bash mvn clean install -DskipTests ``` --- #### 2. 数据库配置 XXL-JOB 使用数据库存储任务信息和其他元数据。需要手动创建数据库并初始化表结构。 - **数据库初始化**: - 在官方文档中提供了 SQL 脚本，用于创建所需的表结构。 - 将脚本导入到 MySQL 数据库中。 - **修改配置文件**: - 编辑 `admin` 模块中的 `application.properties` 文件，设置数据库连接信息。 ```properties spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai spring.datasource.username=root spring.datasource.password=123456 ``` --- #### 3. 配置 Admin 管理后台 Admin 是 XXL-JOB 的管理界面，负责任务的调度和监控。 - **启动 Admin**: - 进入 `xxl-job-admin` 目录，运行以下命令启动服务： ```bash java -jar xxl-job-admin.jar ``` - 默认访问地址为 `http://localhost:8080`，登录用户名为 `admin`，密码为 `123456`。 --- #### 4. 配置执行器 执行器是实际运行任务的模块，需要与 Admin 进行通信。 - **添加依赖**: 在项目的 `pom.xml` 文件中添加以下依赖： ```xml <dependency> <groupId>com.xuxueli</groupId> <artifactId>xxl-job-core</artifactId> <version>2.3.0</version> </dependency> ``` - **配置执行器**: 编辑 `application.yml` 文件，配置执行器相关信息： ```yaml xxl: job: admin: addresses: http://127.0.0.1:8080/xxl-job-admin executor: appname: demoExecutor ip: port: 9999 logpath: ./jobhandler.log logretentiondays: 30 ``` - **编写任务代码**: 创建一个任务类，并实现 `IJobHandler` 接口： ```java import com.xxl.job.core.handler.IJobHandler; import com.xxl.job.core.handler.annotation.XxlJob; @XxlJob("demoJobHandler") public class DemoJobHandler extends IJobHandler { @Override public void execute() throws Exception { System.out.println("任务执行成功！"); } } ``` --- #### 5. 创建与运行任务 在 Admin 管理后台中创建任务，并绑定到对应的执行器。 - **任务类型**: 支持多种任务类型，包括 Cron 表达式、固定延迟、固定频率等。 - **Cron 表达式**: Cron 表达式用于定义任务的执行时间规则。例如，`0 0/1 * * * ?` 表示每分钟执行一次[^2]。 --- #### 6. 原理概述 XXL-JOB 的核心原理基于 Zookeeper 和 Quartz，支持分布式环境下的任务调度[^4]。主要特点包括： - **高可用性**: 支持多节点部署，确保任务不因单点故障而中断。 - **弹性扩容**: 动态调整执行器数量以适应任务负载变化。 - **失效转移**: 当某个执行器不可用时，任务会自动转移到其他可用执行器上。 --- #### 7. 其他注意事项 - **日志管理**: 执行器的日志路径由 `logpath` 参数指定，默认保留 30 天。 - **权限控制**: Admin 提供用户角色管理功能，可根据需求分配不同权限。 - **监控与告警**: 支持通过邮件或其他方式发送任务执行状态的通知。 ---