type
status
date
slug
summary
tags
category
icon
password
Property
Sep 26, 2025 06:10 AM
XXL-JOB速解
这篇记录是最近翻阅刚毕业那会的笔记发现的,现在贴上来了。
XXL-Job:调度器-节点部署
1.1 初始化数据库
1.2 修改调度器项目配置
或者换成Yaml配置
1.3 maven 打包源代码

1.4 打包Docker镜像
dockerFile:
上传文件至服务器

之后执行打包镜像

1.5 启动实例
XXL-Job:执行器-服务接入
任意项目接入XXL—job十分简单,只需要按照如下步骤流程即可。
前置条件:打包 xxl-job-core 为jar包,私服部署Maven仓库,在对应的module引入此依赖:
如果项目结构层次分明,对基础配置有明确的分包处理,那么你可以新建一个模块:
1.1 修改Yaml配置
1.2 配置类
1.3 创建定时任务
1.3.1 编码+配置(SpringBoot3.X版本 & XXL-Job3.X版本)
先创建一个Handler继承IJobHandler,实现execute函数即可
由于Handler需要统一经过XxlJobExecutor处理,因此需要加入到配置中,上面的1.2 配置类需要增加一行代码(绿色标记就是需要新增的代码部分)
1.3.2 注解开发
注解开发更简单,使用Component注解标记为SpringBean之后,使用XxlJob注解标记方法为定时任务函数
1.4 启动项目服务
看到xxl-job注册到admin中心之后就说明配置成功
打开分布式任务调度平台后台管理页面:http://127.0.0.1:6868/xxl-job-admin/
1.5 新增执行器
点击执行器管理,新增执行器,选择自动注册,手动录入需要知道机器IP,自动注册,只需填写项目配置中的AppName即可,名称随意,填入一个项目别称即可,便于区分,自动注册会自动获取对应服务的IP。比如我这里是XXX-project-server,AppName就填入XXX-project-server。
之后就创建成功了,点击查看,可以看到已经有注册进去的IP机器,分布式集群部署的时候,会有多个IP
1.6 任务管理
新增定时任务,按照项目配置中的代码中所编写的JobHandler
这样就创建好了一个任务
1.7 启动服务
XXL-Job:自定义-监控实现
1.1 飞书消息卡片设计地址
https://open.feishu.cn/cardkit/editor?cardId=XXXXXXX
1.2 消息数据结构
1.3 消息Demo

1.4 编码增强
xxl-job没有默认支持飞书通知,要想支持飞书通知,只需要分析一下源码,在Core中,有一个告警调用链路,其中JobAlarm接口,当出现需要告警的内容的时候,调用链路最终会调用这个JobAlarm的实现类,默认实现类是EmailAlarm,如果想自定义,就实现这个接口即可,具体实现位置在:
然后做自定义实现即可,给出一个demo案例:
1.5 测试

- 作者:fntp
- 链接:https://polofox.com/article/xxl-job-note-1
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
相关文章