从零了解xxl-job（分布式任务调度平台）

故事很腻i

已于 2025-04-24 14:57:07 修改

阅读量326

点赞数 4

分类专栏：任务调度文章标签： java tomcat xxl-job

于 2025-04-23 11:18:07 首次发布

本文链接：https://blog.csdn.net/callback_CSDN/article/details/147444260

版权

任务调度专栏收录该内容

1 篇文章

订阅专栏

一、简介

XXL-JOB 是一个分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线，开箱即用。它支持分布式任务调度，任务的可视化管理，丰富的调度策略，并且提供了强大的容错机制，适用于各种定时任务、批量任务等场景。

二、环境要求

JDK：建议使用 JDK 1.8 及以上版本。
MySQL：5.6 及以上版本，用于存储任务调度相关数据。
Web 容器：如 Tomcat 7 及以上版本，用于部署 xxl-job-admin 管理端。

三、安装部署

（一）下载源码

从官方 GitHub 仓库（xxl-job仓库地址）下载最新版本的源码。

（二）数据库初始化

执行 xxl-job/doc/db/tables_xxl_job.sql 脚本，在 MySQL 数据库中创建所需的表结构和初始化数据。

（三）部署 xxl-job-admin

进入 xxl-job/xxl-job-admin 目录，修改 application.properties 配置文件，配置数据库连接信息：

spring:
    datasource:
        url: jdbc:mysql://localhost:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
        username: root
        password: 123456

配置调度中心通讯地址，默认端口为 8080：

xxl:
    job:
        admin:
            addresses: http://localhost:8080/xxl-job-admin

打包项目：

mvn clean package -Dmaven.test.skip=true

将生成的 xxl-job-admin-{version}.jar 文件部署到 Tomcat 等 Web 容器中，并启动容器。

（四）部署 xxl-job-executor

新建一个 Maven 项目，引入 xxl-job-core 依赖：

<dependency>
    <groupId>com.xuxueli</groupId>
    <artifactId>xxl-job-core</artifactId>
    <version>{latest-version}</version>
</dependency>

编写配置类，配置执行器相关信息，例如：

import com.xxl.job.core.executor.impl.XxlJobSpringExecutor;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class XxlJobExecutorConfig {

    @Value("${xxl.job.admin.addresses}")
    private String adminAddresses;

    @Value("${xxl.job.executor.appname}")
    private String appname;

    @Value("${xxl.job.executor.ip}")
    private String ip;

    @Value("${xxl.job.executor.port}")
    private int port;

    @Value("${xxl.job.accessToken}")
    private String accessToken;

    @Value("${xxl.job.executor.logpath}")
    private String logPath;

    @Value("${xxl.job.executor.logretentiondays}")
    private int logRetentionDays;

    @Bean
    public XxlJobSpringExecutor xxlJobExecutor() {
        XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
        xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
        xxlJobSpringExecutor.setAppname(appname);
        xxlJobSpringExecutor.setIp(ip);
        xxlJobSpringExecutor.setPort(port);
        xxlJobSpringExecutor.setAccessToken(accessToken);
        xxlJobSpringExecutor.setLogPath(logPath);
        xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);

        return xxlJobSpringExecutor;
    }
}

编写任务执行类，实现具体的任务逻辑，例如：

import com.xxl.job.core.context.XxlJobHelper;
import com.xxl.job.core.handler.annotation.XxlJob;
import org.springframework.stereotype.Component;

@Component
public class SampleXxlJob {

    @XxlJob("demoJobHandler")
    public void demoJobHandler() throws Exception {
        // 任务逻辑
        for (int i = 0; i < 5; i++) {
            XxlJobHelper.log("这是第 " + i + " 次执行任务");
            // 模拟业务操作
            Thread.sleep(1000);
        }
        XxlJobHelper.handleSuccess("任务执行成功");
    }
}