SpringBoot项目如何对接XXLJob平台

张开发
2026/4/19 3:43:23 15 分钟阅读

分享文章

SpringBoot项目如何对接XXLJob平台
我给你最标准、最简单、直接复制可用的SpringBoot 对接 XXL-Job 完整版平台版只做对接不部署调度中心直接用平台。一、SpringBoot 对接 XXL-Job 平台4步搞定1️⃣ 引入依赖pom.xmldependencygroupIdcom.xuxueli/groupIdartifactIdxxl-job-core/artifactIdversion2.4.0/version/dependency2️⃣ 配置文件application.ymlxxl:job:# 调度中心平台地址平台给你的admin:addresses:http://xxl-job-platform.xxx.com/xxl-job-admin# 执行器配置你自己的服务executor:# 唯一名称平台会给你或自己定义appname:order-service# 执行器端口不冲突即可port:9988# 日志路径logpath:/data/applogs/xxl-job# 日志保留天数logretentiondays:30# 平台给你的令牌必须一致accessToken:xxl-platform-token-1234563️⃣ 配置类XxlJobConfig.javaimportcom.xuxueli.job.core.executor.impl.XxlJobSpringExecutor;importorg.springframework.beans.factory.annotation.Value;importorg.springframework.context.annotation.Bean;importorg.springframework.context.annotation.Configuration;ConfigurationpublicclassXxlJobConfig{Value(${xxl.job.admin.addresses})privateStringadminAddresses;Value(${xxl.job.executor.appname})privateStringappName;Value(${xxl.job.executor.port})privateintport;Value(${xxl.job.accessToken})privateStringaccessToken;BeanpublicXxlJobSpringExecutorxxlJobExecutor(){XxlJobSpringExecutorexecutornewXxlJobSpringExecutor();executor.setAdminAddresses(adminAddresses);executor.setAppname(appName);executor.setPort(port);executor.setAccessToken(accessToken);returnexecutor;}}4️⃣ 写一个任务直接用importcom.xuxueli.job.core.context.XxlJobHelper;importcom.xuxueli.job.core.handler.annotation.XxlJob;importorg.springframework.stereotype.Component;ComponentpublicclassPlatformJob{// 这个名字要去平台配置XxlJob(syncOrderJob)publicvoidsyncOrderJob(){// 日志输出到平台XxlJobHelper.log(开始同步订单——对接平台成功);// 你的业务逻辑 System.out.println(平台定时任务执行);// 成功返回XxlJobHelper.handleSuccess();}}二、平台后台配置你只需要做这一步登录XXL-Job 平台后台进入执行器管理 → 新增AppNameorder-service和你配置一样注册方式自动注册进入任务管理 → 新增JobHandlersyncOrderJob和注解一样Cron自己配启动任务 → 查看日志三、最常见的 3 个问题执行器不在线→ 检查 accessToken、地址、防火墙任务不执行→ JobHandler 名字和平台一致日志看不到→ 用 XxlJobHelper.log()

更多文章