动态创建 XXL-JOB 定时任务案例（实战四）

type

status

date

slug

summary

📝 前言

这是定时任务 XXL-JOB 专题的第五篇，回顾一下前几篇内容：

基本概念介绍：《定时任务之 XXL-JOB 入门介绍》

开发/测试环境快速部署：《使用 Docker 快速部署 XXL-JOB（实战一）》

使用Python执行任务：《使用 Python 执行 XXL-JOB 定时任务（实战二）》

在生产环境中使用XXL-JOB：《使用阿里云ACS部署XXL-JOB指南（实战三）》

这一篇过后定时任务专题也暂时告一段落了。

🧭 背景介绍

经过前几期的介绍，我们知道了如果要使用XXL-JOB，需要手动在调度中心控制台创建执行器和任务。

但是在实际工作中，我们可能会遇到需要动态创建任务的场景，比如：

SaaS 平台根据用户设置自动创建定时任务

自动化脚本批量注册、删除任务

配合 GitOps 或 CI/CD 流程动态同步任务配置

这期我们就再来介绍一下如何调用接口动态创建 XXL-JOB 任务（官方并没有提供 OpenAPI）。

📋 前提条件

在开始之前，请确保你已满足以下条件：

已安装部署 XXL-JOB（可参看文章：《使用 Docker 快速部署 XXL-JOB（实战一）》）

已安装 Python 环境（自行查询安装教程）

熟悉基础的 Python 语言

🚀 详细步骤

1️⃣ 安装依赖库

我们这个示例通过 requests 发送接口请求，因此需要先安装依赖库：

2️⃣ 获取 XXL-JOB 登录 Token

由于 XXL-JOB 官方并没有提供动态创建任务的 OpenAPI 接口，那我们要如何创建呢？

这里我们有两种选择：

修改 XXL-JOB 源码：使其支持通过OpenAPI来进行创建，成本较大。

模拟登录：通过调用中心的 web 接口来动态创建，毕竟能手动创建的肯定也能自动调(笑)，成本较低。

我们先来模拟登录，示例代码如下：

3️⃣ 获取执行器 ID

我们在手动创建任务时，可以发现每个任务必须要选择一个执行器，这里是需要传入执行器的ID字段。

我们在登录成功后就可以调用接口，通过执行器的 AppName 查询到ID，示例代码如下：

4️⃣ 构造任务参数并创建任务

在我们拿到执行器ID后，就可以通过session来调用 web 接口创建任务了，示例代码如下：

主要参数说明：

jobGroup：执行器的ID，可通过动态查询传入

scheduleConf：定时执行时间，示例为一次性任务，在2025-07-12 08:55:00 执行

executorHandler：处理任务的函数名称

5️⃣ 启动任务

最后别忘了，我们手动操作里面还有启动任务这一步，同样我们自动创建的也需要再调一次接口自动启动，示例代码如下：

PS：这里需要注意的是我们在上一步创建的任务调度时间一定要晚于当前时间，不能写昨天的，否则无法启动。

✅ 总结

通过调用 XXL-JOB 的后台接口，我们可以在无需人工干预的情况下，批量、自动地创建调度任务。

这种方式特别适用于平台化、自动化程度高的项目。

关于定时任务 XXL-JOB 的专题分享到这里就暂时告一段落了。

接下来下一期我们将聚焦于 DevOps 系列专题，分享介绍如何使用 Gitea 打造属于自己的 DevOps 平台，感兴趣的同学可以持续关注哈~

💡

有关文章的任何疑问，欢迎您在底部评论区留言，一起交流~

若文章对您有帮助，欢迎请我喝杯咖啡~