Tiny Job

轻量级分布式定时任务调度系统

一个基于SpringBoot+Quartz的的轻量级分布式定时任务调度系统

主要技术选型

1、后端：

• SpringBoot 2.7.18
• Quartz 2.3.2
• Mybatis-Plus 3.5.7
• Httpclient 4.5.13

2、前端：

• Layui 2.8.11
• jQuery 2.1.4

运行环境

• Jdk8
• MySQL5.6+

运行启动教程

1. 新建MySQL数据库并导入sql文件夹下的数据库脚本
2. 修改配置文件中application.yml中数据库连接信息
3. 运行启动类TinyJobApplication，即可正常启动项目
4. 管理后台登录地址：http://localhost:9009 账户密码 admin / 123456

功能特色

1. 项目维度管理：任务与主机的结构化归类

• 引入「项目」核心概念，将分散的主机信息、定时任务按业务场景或团队归属进行分组管理，避免资源混乱
• 支持项目级别的权限隔离（后续规划），为不同团队或业务线提供独立的任务调度空间，数据边界清晰

2. 主机管理：灵活可控的执行器集群配置

• 支持单主机多地址维护（如 http://172.89.56.117:8899、http://172.89.56.118:8899），轻松构建执行器集群
• 集成安全调用策略（待完善），通过签名校验等机制保障任务请求的合法性，防止未授权调用
• 提供 7种路由负载均衡策略，并预留标准化扩展接口，满足不同场景下的任务分发需求：
  • FIRST（固定首地址）：始终选择集群中第一个可用主机
  • LAST（固定尾地址）：始终选择集群中最后一个可用主机
  • ROUND（轮询）：按顺序循环分配任务，确保各主机负载均衡
  • RANDOM（随机）：随机选择可用主机，适用于无明显负载差异的场景
  • LFU（最不经常使用）：优先分配任务给调用频率最低的主机，优化资源利用率
  • LRU（最近最久未使用）：优先分配任务给长时间未调用的主机，避免单点过载
  • CONSISTENT_HASH（一致性哈希）：基于哈希算法固定任务与主机的映射关系，减少任务漂移

3. 任务管理：可视化、高灵活的调度配置

• 全在线操作：支持任务的新增、编辑、删除、手动触发执行，以及实时启停
• 多触发器类型：同时支持 CRON表达式（复杂时间规则，如“每周一凌晨3点”）和 SIMPLE触发器（固定秒数间隔，如“每5秒执行一次”）
• 丰富的任务参数配置：
  • 请求层：支持 GET/POST/POST_JSON 三种请求类型，可自定义请求路径（与主机地址自动拼接）、请求参数（JSON格式）、请求头（JSON格式）
  • 调度层：
    • 调度过期处理规则：针对“任务触发时因系统故障/主机离线导致未执行”的场景，提供3种处理策略：
      • 立即执行：补执行所有错过的未执行任务（如系统宕机1小时，重启后一次性执行这1小时内所有应触发的任务），适用于“数据同步类”需补全数据的场景；
      • 执行一次：仅补执行1次最近错过的任务，且从当前时间重新计算下次触发时间（如每10分钟执行1次，宕机30分钟后重启，仅执行1次，下次按重启时间+10分钟触发），适用于“通知类”避免重复推送的场景；
      • 放弃执行（默认）：忽略所有错过的未执行任务，直接从当前时间开始计算下次触发时间（如每小时执行1次，宕机2小时后重启，下次按重启时间+1小时触发），适用于“实时性要求低”无需补执行的场景；
    • 并发执行控制：支持两种执行模式，适配不同任务特性：
      • 允许并发：同一任务的前一次执行未结束时，若到达下一次触发时间，直接启动新的执行进程（如任务执行耗时15秒，触发间隔10秒，会同时存在2个执行进程），适用于“无状态、可并行”的任务（如多节点数据独立查询）；
      • 禁止并发（单机串行）：同一任务的前一次执行未结束时，阻塞下一次触发（需等前一次执行完成后，再判断是否触发下一次任务），避免因并发导致的数据冲突（如任务操作同一数据库表，并发执行可能引发锁表/数据不一致）；
• 内置CRON表达式生成器：可视化配置时间规则，无需手动编写复杂表达式，降低使用门槛

4. 任务执行日志：安全可追溯的调度记录

• 完整记录任务执行信息：包括执行时间、执行主机、请求参数、响应结果、执行状态（成功/失败）、耗时等，问题排查更高效
• 日志安全保护：采用国密SM3算法对日志内容进行签名，确保日志未被篡改，满足数据完整性校验需求

5. 预警配置：任务异常的及时感知

• 支持预警邮箱配置，当任务执行失败（如请求超时、返回错误码）时，系统自动发送告警邮件，及时通知运维人员处理，减少故障影响范围

平台功能界面展示

首页

项目管理

项目管理-编辑

主机管理

主机管理-编辑

任务管理

任务管理-编辑

任务日志

CRON生成

执行器主机安全策略配置

待完成

项目计划

功能模块	状态	说明
Mock核心功能	✅ 已完成	提供接口Mock能力，支持模拟任务请求的返回结果，便于调试
项目管理	✅ 已完成	实现项目的创建、编辑、删除，以及任务/主机与项目的关联
接口管理	✅ 已完成	管理任务关联的接口信息，支持接口参数、请求方式等配置
接口修改历史	✅ 已完成	记录接口配置的修改日志，支持回溯历史版本，便于问题定位
接口访问日志	✅ 已完成	记录接口的调用记录，包括调用时间、调用者、请求参数、响应结果等
邀请码注册	✅ 已完成	通过邀请码机制控制注册权限，保障系统访问安全
首页大屏	✅ 已完成	可视化展示下的任务执行概况、主机状态、异常统计等核心数据
数据统计页面	✅ 已完成	提供任务执行成功率、主机负载、接口调用量等统计图表，辅助运营决策
项目成员协作功能	✅ 已完成	支持多成员协作管理同一项目，实现权限共享（基础版）
项目导出/导入	✅ 已完成	支持项目级数据的备份（导出）与恢复（导入），便于环境迁移或数据备份
自定义头像修改	✅ 已完成	支持/用户自定义头像，提升系统个性化体验
接口分模块管理	📅️ 待完成	支持接口按业务模块分组管理，适用于接口数量较多的复杂项目
主机节点监控与上下线	✅ 已完成	内置定时监控任务，主动检测主机存活状态，实现故障节点自动下线、恢复后上线
角色与权限管理	📅 待完成	区分管理员、操作员等角色，支持按项目维度分配权限（如“仅查看任务”“可编辑任务”）
任务失败告警增强	📅 待完成	增加webhook告警（如企业微信机器人、钉钉机器人、自建告警平台），支持自定义告警URL、请求体格式
任务回调功能	📅 待完成	添加任务执行成功/失败回调功能，任务结束后回调到任务中心[JobClient.handleSuccess(msg)，JobClient.handleFail(msg) ]
主机自动注册	📅 待完成	通过继承 tinyjob-client 来实现主机自动注册功能
广播任务	📅 待完成

常用cron表达式示例

• 0/2 * * * * ? 表示每2秒 执行任务

• 0 0/2 * * * ? 表示每2分钟 执行任务

• 0 0 2 1 * ? 表示在每月的1日的凌晨2点调整任务

• 0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15执行作业

• 0 15 10 ? 6L 2002-2006 表示2002-2006年的每个月的最后一个星期五上午10:15执行作

• 0 0 10,14,16 * * ? 每天上午10点，下午2点，4点

• 0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时

• 0 0 12 ? * WED 表示每个星期三中午12点

• 0 0 12 * * ? 每天中午12点触发

• 0 15 10 ? * * 每天上午10:15触发

• 0 15 10 * * ? 每天上午10:15触发

• 0 15 10 * * ? 每天上午10:15触发

• 0 15 10 * * ? 2005 2005年的每天上午10:15触发

• 0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发

• 0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发

• 0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发

• 0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发

• 0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发

• 0 15 10 ? * MON-FRI 周一至周五的上午10:15触发

• 0 15 10 15 * ? 每月15日上午10:15触发

• 0 15 10 L * ? 每月最后一日的上午10:15触发

• 0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发

• 0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发

• 0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发