XXJOB极简入门：零基础搭建第一个分布式定时任务
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个面向新手的XXJOB教学项目，要求：1) 最简单的HTTP任务示例，每分钟打印'Hello World'；2) 包含XXJOB控制台的安装配置说明；3) 常见错误解决方案（端口冲突/依赖缺失等）。使用Markdown格式输出教程，附带可直接运行的Docker Compose配置。- 点击'项目生成'按钮，等待项目生成完整后预览效果
XXJOB极简入门：零基础搭建第一个分布式定时任务
最近在项目中需要用到分布式定时任务调度，调研了几款主流框架后选择了XXJOB。作为新手入门时发现网上的教程要么太复杂，要么缺少关键步骤说明。经过几天摸索，终于跑通了最简单的Hello World示例，把完整流程整理成这篇新手友好指南。
XXJOB基础认知
XXJOB是一个轻量级分布式任务调度平台，核心优势在于：
- 通过简单的Web界面就能管理所有定时任务
- 支持动态调整任务执行策略
- 自带任务失败重试和日志记录功能
- 采用中心化调度+分布式执行的架构
环境准备
- 安装Docker和Docker Compose（推荐使用最新稳定版）
- 准备至少2GB可用内存
- 确保8080端口未被占用（如需修改端口后续会说明）
快速启动控制台
用Docker Compose是最简单的部署方式，新建docker-compose.yml文件：
- 配置MySQL容器作为XXJOB的数据库
- 设置XXJOB管理端容器并链接数据库
- 暴露8080端口供浏览器访问
启动后访问http://localhost:8080/xxl-job-admin，默认账号admin/123456
常见问题处理： - 若8080端口冲突，修改docker-compose中ports配置 - 启动失败检查MySQL容器是否正常初始化 - 日志报错时尝试删除旧容器重新创建
创建第一个任务
- 在控制台"任务管理"添加新任务
- 选择BEAN模式（最简单的HTTP调用方式）
- 配置JobHandler为demoJobHandler
- 设置Cron表达式"0 * * * * ?"表示每分钟执行
- 任务参数填写"Hello World"
编写执行器代码
- 新建Spring Boot项目添加xxl-job-core依赖
- 在application.yml配置执行器信息
- 创建任务处理类添加@XxlJob注解
- 方法内实现简单的日志打印逻辑
启动执行器后，在控制台可以看到自动注册的执行器地址。手动触发一次任务测试，在日志中应该能看到输出的Hello World信息。
进阶提示
- 生产环境建议配置多个执行器实例实现高可用
- 复杂任务可以通过分片广播方式并行处理
- 任务参数支持动态传递运行时变量
- 记得配置邮件报警接收任务失败通知
整个搭建过程在InsCode(快马)平台上操作特别流畅，不需要手动配置各种环境，一键部署就能看到运行效果。他们的在线编辑器直接集成了终端和预览功能，调试代码非常方便，特别适合新手快速验证想法。
遇到任何问题欢迎在评论区交流，后续会继续分享XXJOB在实际项目中的高级用法。刚开始可能觉得配置项有点多，但熟悉之后会发现这套系统设计得非常合理，基本覆盖了定时任务的所有使用场景。
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个面向新手的XXJOB教学项目，要求：1) 最简单的HTTP任务示例，每分钟打印'Hello World'；2) 包含XXJOB控制台的安装配置说明；3) 常见错误解决方案（端口冲突/依赖缺失等）。使用Markdown格式输出教程，附带可直接运行的Docker Compose配置。- 点击'项目生成'按钮，等待项目生成完整后预览效果