感兴趣的朋友们可以Follow下：想惑1025。
XXL-JOB官网：分布式任务调度平台XXL-JOB
配置文件
xxl:
job:
admin:
# 调度中心部署跟地址 [选填]：如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"；为空则关闭自动注册；
addresses: http://127.0.0.1:8080/xxl-job-admin
# 执行器通讯TOKEN [选填]：非空时启用；
accessToken:
executor:
# 执行器AppName [选填]：执行器心跳注册分组依据；为空则关闭自动注册
appname:
# 执行器IP [选填]：默认为空表示自动获取IP，多网卡时可手动设置指定IP，该IP不会绑定Host仅作为通讯实用；地址信息用于 "执行器注册" 和 "调度中心请求并触发任务"；
ip:
# 执行器端口号 [选填]：小于等于0则自动获取；默认端口为9999，单机部署多个执行器时，注意要配置不同执行器端口；
port: 9999
# 执行器运行日志文件存储磁盘路径 [选填] ：需要对该路径拥有读写权限；为空则使用默认路径；
logpath: /data/applogs/xxl-job/jobhandler
# 执行器日志保存天数 [选填] ：值大于3时生效，启用执行器Log文件定期清理功能，否则不生效；
logretentiondays: -1JobHandler业务实现类
package org.etoak;
import com.xxl.job.core.biz.model.ReturnT;
import com.xxl.job.core.handler.IJobHandler;
import com.xxl.job.core.handler.annotation.JobHandler;
@JobHandler(value = "MyJobHandler")
public class MyJobHandler extends IJobHandler {
@Override
public ReturnT<String> execute(String taskParam) {
System.out.println(">>>>>>>>>定时任务begin*********************");
return SUCCESS;
}
}正常向xxl-admin注册jobHandler的方式有两种，官网这样描述
如果已经正确进行上述配置，可将执行器项目编译打部署，系统提供多种执行器Sample示例项目，选择其中一个即可，各自的部署方式如下。
xxl-job-executor-sample-springboot：项目编译打包成springboot类型的可执行JAR包，命令启动即可；xxl-job-executor-sample-frameless：项目编译打包成JAR包，命令启动即可；
要么是以web容器运行，要么以jar包运行，最终的目的就是要java进程一直保持运行。
其实通过XxlJobSpringExecutor可以自动扫描带@JobHandler的IJobHandler实现类来向xxl-admin进行注册，但是有些业务场景需要手动注册
手动注册代码如下：
// ...
// 配置需要注册的实现类(多个，比如: com.etoak.实现类1,org.etoak.实现类2)
// 反射生成实现类的实例clazz
// ...
// 有@JobHandler的类实例，注册为jobHandler
JobHandler jobHandlerAnnotation = clazz.getAnnotation(JobHandler.class);
if (jobHandlerAnnotation != null) {
String jobHandlerAnnotationName = jobHandlerAnnotation.value();
if (StringUtils.hasLength(jobHandlerAnnotationName)) {
BeanDefinitionBuilder beanDefinitionBuilder = BeanDefinitionBuilder.genericBeanDefinition(clazz);
//注册Bean
defaultListableBeanFactory.registerBeanDefinition(jobHandlerAnnotationName, beanDefinitionBuilder.getBeanDefinition());
IJobHandler handler = (IJobHandler) o;
if (XxlJobExecutor.loadJobHandler(jobHandlerAnnotationName) != null) {
logger.error(">>>>>>>>>>>>>>>>>>>>>JobHandler名称【{}】已被注册，请检查！", jobHandlerAnnotationName);
}
XxlJobExecutor.registJobHandler(jobHandlerAnnotationName, handler);
logger.info(">>>>>>>>>>>>>>>>>>>>>注册JobHandler成功【{}】", jobHandlerAnnotationName);
} else {
logger.error(">>>>>>>>>>>>>>>>>>>>>【{}】的@JobHandler字段value为空，请检查！", clazzName);
}
}===============================================
根据注解获取所有bean
applicationContext.getBeansWithAnnotation(JobHandler.class)// 自动注册
// ***admin***
// 服务启动时
XxlJobDynamicScheduler.initRpcProvider
XxlJobDynamicScheduler.getExecutorBiz
AdminBizImpl
JobRegistryMonitorHelper
XxlJobServiceImpl
// 客户端启动时
XxlRpcProviderFactory.initConfig
XxlRpcProviderFactory.invokeService
// ***xxl-core***
ExecutorRegistryThread.start
XxlJobExecutor.start
XxlJobExecutor.initAdminBizList
// ***rpc-core***
XxlRpcReferenceBean
// 执行
NettyHttpServerHandler.channelRead0
NettyHttpServerHandler.process
XxlRpcProviderFactory.invokeService项目上使用的xxl-job版本为2.0.2-SNAPSHOT，依赖的spring-boot版本为1.5.20.RELEASE，有点低。因为需要引入jasypt-spring-boot-starter对配置文件敏感信息加密，需要提高spring-boot版本。
现在打算将spring-boot版本提高至2.7.18，但是报以下异常：
10:09:02.722 logback [main] INFO org.quartz.impl.StdSchedulerFactory - Using default implementation for ThreadExecutor
10:09:02.735 logback [main] INFO o.quartz.core.SchedulerSignalerImpl - Initialized Scheduler Signaller of type: class org.quartz.core.SchedulerSignalerImpl
10:09:02.735 logback [main] INFO org.quartz.core.QuartzScheduler - Quartz Scheduler v.2.3.1 created.
10:09:02.737 logback [main] INFO org.quartz.core.QuartzScheduler - Scheduler DefaultQuartzScheduler_$_tian001704420542724 shutting down.
10:09:02.738 logback [main] INFO org.quartz.core.QuartzScheduler - Scheduler DefaultQuartzScheduler_$_tian001704420542724 paused.
10:09:02.742 logback [main] WARN o.q.impl.jdbcjobstore.JobStoreTX - Database connection shutdown unsuccessful.
java.sql.SQLException: There is no DataSource named 'null'
at org.quartz.utils.DBConnectionManager.shutdown(DBConnectionManager.java:135)
at org.quartz.impl.jdbcjobstore.JobStoreSupport.shutdown(JobStoreSupport.java:746)
at org.quartz.core.QuartzScheduler.shutdown(QuartzScheduler.java:732)
at org.quartz.impl.StdSchedulerFactory.shutdownFromInstantiateException(StdSchedulerFactory.java:1419)
at org.quartz.impl.StdSchedulerFactory.instantiate(StdSchedulerFactory.java:1379)
at org.quartz.impl.StdSchedulerFactory.getScheduler(StdSchedulerFactory.java:1567)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.createScheduler(SchedulerFactoryBean.java:679)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.prepareScheduler(SchedulerFactoryBean.java:616)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.afterPropertiesSet(SchedulerFactoryBean.java:504)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1863)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1800)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:620)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:542)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:335)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:234)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:333)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:208)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:936)
at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:929)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:591)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:147)
at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:732)
at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:409)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:308)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1300)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1289)
at com.xxl.job.admin.XxlJobAdminApplication.main(XxlJobAdminApplication.java:13)
10:09:02.743 logback [main] INFO org.quartz.core.QuartzScheduler - Scheduler DefaultQuartzScheduler_$_tian001704420542724 shutdown complete.
10:09:02.746 logback [main] WARN o.s.b.w.s.c.AnnotationConfigServletWebServerApplicationContext - Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'getSchedulerFactoryBean' defined in class path resource [com/xxl/job/admin/core/conf/XxlJobDynamicSchedulerConfig.class]: Invocation of init method failed; nested exception is org.quartz.SchedulerConfigException: DataSource name not set.
10:09:02.750 logback [main] INFO o.a.catalina.core.StandardService - Stopping service [Tomcat]
10:09:02.770 logback [main] INFO o.s.b.a.l.ConditionEvaluationReportLoggingListener -
Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
10:09:02.810 logback [main] ERROR o.s.boot.SpringApplication - Application run failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'getSchedulerFactoryBean' defined in class path resource [com/xxl/job/admin/core/conf/XxlJobDynamicSchedulerConfig.class]: Invocation of init method failed; nested exception is org.quartz.SchedulerConfigException: DataSource name not set.
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1804)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:620)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:542)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:335)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:234)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:333)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:208)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:936)
at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:929)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:591)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:147)
at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:732)
at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:409)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:308)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1300)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1289)
at com.xxl.job.admin.XxlJobAdminApplication.main(XxlJobAdminApplication.java:13)
Caused by: org.quartz.SchedulerConfigException: DataSource name not set.
at org.quartz.impl.jdbcjobstore.JobStoreSupport.initialize(JobStoreSupport.java:643)
at org.quartz.impl.jdbcjobstore.JobStoreTX.initialize(JobStoreTX.java:57)
at org.quartz.impl.StdSchedulerFactory.instantiate(StdSchedulerFactory.java:1356)
at org.quartz.impl.StdSchedulerFactory.getScheduler(StdSchedulerFactory.java:1567)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.createScheduler(SchedulerFactoryBean.java:679)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.prepareScheduler(SchedulerFactoryBean.java:616)
at org.springframework.scheduling.quartz.SchedulerFactoryBean.afterPropertiesSet(SchedulerFactoryBean.java:504)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1863)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1800)
... 16 common frames omitted解决方式一：将spring-boot版本降至2.5.6或以下
解决方式二：修改quatz.propeties文件
# org.quartz.jobStore.class: org.quartz.impl.jdbcjobstore.JobStoreTX
# 将上面配置改为此配置
org.quartz.jobStore.class: org.springframework.scheduling.quartz.LocalDataSourceJobStore另外，升级spring-boot版本，数据源也由org.apache.tomcat.jdbc.pool.DataSource改为com.zaxxer.hikari.HikariDataSource
#spring.datasource.type=org.apache.tomcat.jdbc.pool.DataSource
#spring.datasource.tomcat.max-wait=10000
#spring.datasource.tomcat.max-active=30
#spring.datasource.tomcat.test-on-borrow=true
#spring.datasource.tomcat.validation-interval=30000
spring.datasource.hikari.pool-name=xxl-pool
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.max-lifetime=60000
spring.datasource.hikari.idle-timeout=30000
spring.datasource.hikari.maximum-pool-size=100
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.connection-test-query=SELECT 1另外还有一个问题，会发现所有的资源都找不到：
11:40:41.083 logback [http-nio-8181-exec-3] WARN o.s.web.servlet.PageNotFound - No mapping for GET /xxl-job-admin/jobinfo
11:40:41.859 logback [http-nio-8181-exec-1] WARN o.s.web.servlet.PageNotFound - No mapping for GET /xxl-job-admin/jobinfo
11:40:44.927 logback [http-nio-8181-exec-4] WARN o.s.web.servlet.PageNotFound - No mapping for GET /xxl-job-admin
11:40:45.320 logback [http-nio-8181-exec-5] WARN o.s.web.servlet.PageNotFound - No mapping for GET /xxl-job-admin如果用的模板引擎是freemarker，还需要主要springboot版本升级之后默认的模板文件后缀名变化，由ftl变为ftlh，继续使用ftl，需增加配置
spring.freemarker.suffix=.ftl
原因在这：
# server.context-path=/xxl-job-admin
server.servlet.context-path=/xxl-job-admin
# spring.resources.static-locations=classpath:/static/
spring.web.resources.static-locations=classpath:/static/
配置属性详细说明（官网）：
基础配置：
- 执行器：任务的绑定的执行器，任务触发调度时将会自动发现注册成功的执行器, 实现任务自动发现功能; 另一方面也可以方便的进行任务分组。每个任务必须绑定一个执行器, 可在 "执行器管理" 进行设置;
- 任务描述：任务的描述信息，便于任务管理；
- 负责人：任务的负责人；
- 报警邮件：任务调度失败时邮件通知的邮箱地址，支持配置多邮箱地址，配置多个邮箱地址时用逗号分隔；
触发配置：
- 调度类型：
无：该类型不会主动触发调度；
CRON：该类型将会通过CRON，触发任务调度；
固定速度：该类型将会以固定速度，触发任务调度；按照固定的间隔时间，周期性触发；
固定延迟：该类型将会以固定延迟，触发任务调度；按照固定的延迟时间，从上次调度结束后开始计算延迟时间，到达延迟时间后触发下次调度；
- CRON：触发任务执行的Cron表达式；
- 固定速度：固定速度的时间间隔，单位为秒；
- 固定延迟：固定延迟的时间间隔，单位为秒；
任务配置：
- 运行模式：
BEAN模式：任务以JobHandler方式维护在执行器端；需要结合 "JobHandler" 属性匹配执行器中任务；
GLUE模式(Java)：任务以源码方式维护在调度中心；该模式的任务实际上是一段继承自IJobHandler的Java类代码并 "groovy" 源码方式维护，它在执行器项目中运行，可使用@Resource/@Autowire注入执行器里中的其他服务；
GLUE模式(Shell)：任务以源码方式维护在调度中心；该模式的任务实际上是一段 "shell" 脚本；
GLUE模式(Python)：任务以源码方式维护在调度中心；该模式的任务实际上是一段 "python" 脚本；
GLUE模式(PHP)：任务以源码方式维护在调度中心；该模式的任务实际上是一段 "php" 脚本；
GLUE模式(NodeJS)：任务以源码方式维护在调度中心；该模式的任务实际上是一段 "nodejs" 脚本；
GLUE模式(PowerShell)：任务以源码方式维护在调度中心；该模式的任务实际上是一段 "PowerShell" 脚本；
- JobHandler：运行模式为 "BEAN模式" 时生效，对应执行器中新开发的JobHandler类“@JobHandler”注解自定义的value值；
- 执行参数：任务执行所需的参数；
高级配置：
- 路由策略：当执行器集群部署时，提供丰富的路由策略，包括；
FIRST（第一个）：固定选择第一个机器；
LAST（最后一个）：固定选择最后一个机器；
ROUND（轮询）：；
RANDOM（随机）：随机选择在线的机器；
CONSISTENT_HASH（一致性HASH）：每个任务按照Hash算法固定选择某一台机器，且所有任务均匀散列在不同机器上。
LEAST_FREQUENTLY_USED（最不经常使用）：使用频率最低的机器优先被选举；
LEAST_RECENTLY_USED（最近最久未使用）：最久未使用的机器优先被选举；
FAILOVER（故障转移）：按照顺序依次进行心跳检测，第一个心跳检测成功的机器选定为目标执行器并发起调度；
BUSYOVER（忙碌转移）：按照顺序依次进行空闲检测，第一个空闲检测成功的机器选定为目标执行器并发起调度；
SHARDING_BROADCAST(分片广播)：广播触发对应集群中所有机器执行一次任务，同时系统自动传递分片参数；可根据分片参数开发分片任务；
- 子任务：每个任务都拥有一个唯一的任务ID(任务ID可以从任务列表获取)，当本任务执行结束并且执行成功时，将会触发子任务ID所对应的任务的一次主动调度。
- 调度过期策略：
- 忽略：调度过期后，忽略过期的任务，从当前时间开始重新计算下次触发时间；
- 立即执行一次：调度过期后，立即执行一次，并从当前时间开始重新计算下次触发时间；
- 阻塞处理策略：调度过于密集执行器来不及处理时的处理策略；
单机串行（默认）：调度请求进入单机执行器后，调度请求进入FIFO队列并以串行方式运行；
丢弃后续调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，本次请求将会被丢弃并标记为失败；
覆盖之前调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，将会终止运行中的调度任务并清空队列，然后运行本地调度任务；
- 任务超时时间：支持自定义任务超时时间，任务运行超时将会主动中断任务；
- 失败重试次数；支持自定义任务失败重试次数，当任务失败时将会按照预设的失败重试次数主动进行重试；
扫一扫
4835
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
