xxl-Job配置的方法

XXL-JOB是一个轻量级分布式任务调度平台,其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线,开箱即用。

一、pom中加依赖

有的时候会提示版本冲突,所以排除jackson

 <dependency>
            <groupId>com.xuxueli</groupId>
            <artifactId>xxl-job-core</artifactId>
            <version>2.0.2</version>
            <exclusions>
                <exclusion>
                    <groupId>com.fasterxml.jackson.core</groupId>
                    <artifactId>jackson-databind</artifactId>
                </exclusion>
            </exclusions> 
 </dependency>

二、配置yml文件

##xxl-job
xxl:
  job:
    admin:
      addresses: http://d-xxljob.dmsd.tech:8081/job-admin-dev
    executor:
      appname: xxt-job
      ip:
      port: 9999
      logpath:
      logretentiondays: -1
    accessToken:

addresses:xxl-job的地址,如果有多个地址,用逗号分隔开。

appname: xxl-job执行器的名字

ip:执行器ip,选填,为空会自动获取ip

port:执行器端口号,选填,为空默认为9999

logpath:执行器运行日志文件存储磁盘路径,选填,为空使用默认路径

logretentiondays: 执行器日志保存天数,选填,值大于3时生效

三、xxl-job配置类

package com.dmsd.rank.config;

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


@Configuration
@ComponentScan(basePackages = "com.dmsd.rank.controller.dynamiccrawl")
public class XxlJobConfig {
    private Logger logger = LoggerFactory.getLogger(XxlJobConfig.class);

    @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(initMethod = "start", destroyMethod = "destroy")
    public XxlJobSpringExecutor xxlJobExecutor() {
        logger.info(">>>>>>>>>>> xxl-job config init.");
        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;
    }


}

注:basePackages 为使用xxl-job的类文件夹

四、设置xxl-job的功能代码

package com.dmsd.rank.controller.dynamiccrawl;

import com.dmsd.rank.utils.WeekUtil;
import com.xxl.job.core.biz.model.ReturnT;
import com.xxl.job.core.handler.IJobHandler;
import com.xxl.job.core.handler.annotation.JobHandler;
import com.xxl.job.core.log.XxlJobLogger;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.text.ParseException;
import java.util.concurrent.TimeUnit;

import static com.xxl.job.core.biz.model.ReturnT.SUCCESS;


@Component
@JobHandler(value = "dynamic-rank-crawl")
public class TestCrawl extends IJobHandler {
    @Override
    public ReturnT<String> execute(String s) throws Exception {
        XxlJobLogger.log("XXL-JOB, Hello World.");

        for (int i = 0; i < 5; i++) {
            XxlJobLogger.log("beat at:" + i);
            TimeUnit.SECONDS.sleep(2);
        }
        return SUCCESS;
    }
}

五、执行器管理

点击新增执行器后

六、任务管理

点击新增任务后

 

七、启动项目

1、启动项目后端

2、点击启动

3、查看日志

<think>嗯,用户想了解XXL-JOB配置教程和常见问题。首先,我需要回忆一下XXL-JOB的基本结构和配置步骤。根据之前的引用内容,配置包括管理平台和执行器两部分。管理平台需要配置数据库和调度中心,而执行器部分需要依赖引入和配置文件设置。 用户可能遇到的常见问题包括执行器无法注册、任务不触发、日志查看问题等。比如执行器无法注册可能是因为地址错误或网络不通,这时候需要检查地址和端口是否正确,以及防火墙设置。任务不触发可能与Cron表达式有关,或者任务没有正确启用。日志问题可能需要检查日志路径和权限。 另外,报警机制也是用户关心的部分,引用中提到邮件报警和扩展报警方式,需要确保报警配置正确,比如邮件服务器设置是否正确。还有执行器项目配置,比如Spring Boot中的配置项,是否填对了调度中心的地址。 还要考虑用户的环境,比如是否使用了正确的XXL-JOB版本,依赖冲突是否存在,尤其是在整合Spring Boot或SSM时。引用里提到了SSM集成报错的解决方案,可能需要检查配置文件和注解是否正确。 需要分步骤讲解配置教程,先搭建管理平台,然后配置执行器,最后创建任务。每一步都要详细说明,比如修改application.properties中的数据库连接,配置执行器的appname和地址,调度中心的地址等。常见问题部分要针对每个问题给出解决方法,可能还要提醒用户查阅官方文档和社区资源。 最后,生成的相关问题要涵盖性能优化、高可用配置、日志管理、报警机制和容器部署,这些是用户可能进一步想了解的内容。确保回答结构清晰,引用正确,比如引用[^1]提到报警机制,引用[^3]关于环境搭建,引用[^4]的GitHub源码链接。</think>### XXL-JOB 配置教程及常见问题解答 #### 一、XXL-JOB 核心配置教程 1. **管理平台配置** - **数据库初始化** 修改调度中心配置文件 `application.properties`,配置数据库连接: ```properties spring.datasource.url=jdbc:mysql://localhost:3306/xxl_job?useUnicode=true spring.datasource.username=root spring.datasource.password=root ``` 执行SQL脚本 `tables_xxl_job.sql` 完成表结构初始化[^3]。 - **调度中心配置** 配置调度中心端口和日志路径: ```properties server.port=8080 xxl.job.logpath=/data/applogs/xxl-job/jobhandler ``` 2. **执行器配置(以Spring Boot为例)** - **依赖引入** ```xml <dependency> <groupId>com.xuxueli</groupId> <artifactId>xxl-job-core</artifactId> <version>{xxl-job-version}</version> </dependency> ``` 版本号需与管理平台一致[^2]。 - **配置文件** ```properties # 执行器名称(需与调度中心配置一致) xxl.job.executor.appname=xxl-job-executor-sample # 执行器IP和端口 xxl.job.executor.ip= xxl.job.executor.port=9999 # 调度中心地址 xxl.job.admin.addresses=http://localhost:8080/xxl-job-admin ``` 若未指定IP,执行器会自动获取本机IP[^2]。 3. **任务配置** - 在调度中心控制台添加任务,填写以下关键字段: - **JobHandler**:与代码中 `@XxlJob("demoJobHandler")` 注解名称一致 - **Cron表达式**:如 `0 0 0 * * ?` 表示每日零点执行 - **路由策略**:选择任务分片方式(如轮询、随机等)。 --- #### 二、常见问题及解决方案 1. **执行器无法注册到调度中心** - 检查执行器配置的 `xxl.job.admin.addresses` 是否正确,确保网络可连通。 - 验证执行器端口是否被防火墙拦截(默认9999)。 2. **任务触发但未执行** - 确认 `@XxlJob` 注解的JobHandler名称与调度中心配置完全一致。 - 检查执行器日志 `/data/applogs/xxl-job/jobhandler` 是否有错误堆栈。 3. **Cron表达式不生效** - 使用在线工具(如CronMaker)验证表达式合法性。 - 注意表达式需符合Quartz格式(秒 分 时 日 月 周)。 4. **报警通知失败** - 检查调度中心邮件配置:`spring.mail.host/smtp` 和发件人账号密码。 - 验证接收邮箱是否被标记为垃圾邮件。 5. **SSM/Spring Boot集成报错** - 确保XML配置文件中已正确声明 `XxlJobSpringExecutor` Bean。 - 排查依赖冲突,建议保持Spring Boot版本与XXL-JOB兼容(如2.3.x以上)。 --- #### 三、最佳实践建议 1. **高可用部署** 部署多个调度中心实例,通过Nginx反向代理实现负载均衡。 2. **任务分片优化** 对大任务使用分片策略:`ShardingUtil.getShardIndex()` 处理数据分片[^4]。 3. **日志追踪** 通过调度中心“执行日志”标签实时查看任务状态,支持根据日志ID精准定位。 ---
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值