snail-job 发行版

2026-04-23 07:52

最后提交信息为： feat(1.10.0): 发布1.10.0

vsj1.10.0

a0adbf4

2026-03-14 10:59

SnailJob 1.10.0-beta1

### 新增功能
1. **业务ID(bizId)支持**
   - 新增基于业务ID的任务与工作流操作支持
   - 支持基于bizId的任务和工作流导入导出逻辑
   - Job上下文增加jobBizId字段

2. **OpenAPI接口增强**
   - check-biz-id接口支持id参数用于修改场景过滤
   - 添加bizId参数以支持Job和Workflow的名称列表查询
   - 限制getWorkflowNameList接口的分页大小为10并添加描述字段到WorkflowDetailResponse

3. **Web前端功能**
   - 添加和更新bizId相关逻辑，包括生成、验证和搜索功能
   - 添加 jobId 参数并优化任务名称和业务 ID 选中逻辑
   - 工作流添加和更新bizId相关逻辑

### 功能优化
1. 优化服务端rpc超时配置
2. 简化bizId复制逻辑并刷新表单校验状态
3. 清空任务名称和业务ID选中状态并清除缓存
4. 更新搜索表单按钮布局以统一宽度

### BUG修复
1. 修复查询批次jobId缓存未清空问题
2. 修复https://gitee.com/aizuda/snail-job/issues/IDJNUS
3. 修复https://gitee.com/aizuda/snail-job/issues/IDNFOM

**MYSQL变更(其他DB变更请自行同步)**

> 全量的SQL请参考项目 /doc/sql/x.sql
```mysql
-- 第一步：为sj_job表添加biz_id字段
ALTER TABLE `sj_job` ADD COLUMN `biz_id` varchar(64) NOT NULL DEFAULT '' COMMENT '业务ID' AFTER `namespace_id`;
ALTER TABLE `sj_workflow` ADD COLUMN `biz_id` varchar(64) NOT NULL DEFAULT '' COMMENT '业务ID' AFTER `namespace_id`;

-- 第二步：使用id值初始化sj_job表的biz_id字段
-- 说明：将id转换为varchar字符串赋值给biz_id，确保唯一性
UPDATE `sj_job`
SET `biz_id` = CONCAT('job_', LPAD(id, 16, '0'))
WHERE `biz_id` = '' OR `biz_id` IS NULL;

UPDATE `sj_workflow`
SET `biz_id` = CONCAT('workflow_', LPAD(id, 16, '0'))
WHERE `biz_id` = '' OR `biz_id` IS NULL;

-- 第三步：添加唯一约束
ALTER TABLE `sj_job` ADD UNIQUE KEY `uk_sj_job_01` (`namespace_id`, `biz_id`);
ALTER TABLE `sj_workflow` ADD UNIQUE KEY `uk_sj_workflow_01` (`namespace_id`, `biz_id`);

```

最后提交信息为： feat(1.10.0): 修改日志类型

vsj1.9.0

307cf7d

2025-12-21 20:18

Snail Job 1.9.0

最后提交信息为： feat(1.9.0): 发布1.9.0

vsj1.8.1

3675be4

2025-11-02 21:55

Snail Job 1.8.1

最后提交信息为： feat(1.8.1): 前端打包

vsj1.8.0

2580056

2025-09-22 22:39

Snail Job 1.8.0

最后提交信息为： feat(1.8.0): 升级版本

vsj1.8.0-beta1

e13665e

2025-09-07 22:51

Snail Job 1.8.0-beta1

最后提交信息为： feat(1.8.0-beta1): 打包前端

vsj1.7.2

b92a157

2025-08-14 22:20

Snail Job 1.7.2

最后提交信息为： feat(1.7.2): 发布1.7.2

vsj1.7.1

bd6c368

2025-08-06 21:26

Snail Job 1.7.1

最后提交信息为： feat(1.7.1): 发布1.7.1

vsj1.7.0

1949147

2025-08-03 17:02

Snail Job 1.7.0

最后提交信息为： fix(1.7.0): 发布1.7.0

vsj1.7.0-beta1

7f5529f

2025-07-28 23:41

Snail Job 1.7.0-beta1

最后提交信息为： fix(1.7.0-beta1): 修复Project name is missing问题

vsj1.6.0

f1f1fc2

2025-07-14 21:08

Snail Job 1.6.0

最后提交信息为： feat(1.6.0): 发布1.6.0 正式版本

vsj1.6.0-beta1

6d119ab

2025-06-22 11:55

Snail Job 1.6.0-beta1

**重试机制增强**

1. 支持 `retryIfResult`：根据方法返回结果判断是否重试
2. 支持自定义返回值与异常处理（当配置为`isThrowException=false`时支持`MethodResult`）
3. 支持多个参数序列化器同时使用
4. 新增Fury序列化工具（Fury Serializer）
5. 增加任务标签字段
6. 新增负责人配置

**定时任务增强**

1. 支持任务指定时间点触发（时间点调度）
2. 增加定时任务标签字段
3. JAVA SDK 支持标签和时间点执行
4. 新增执行器同步服务端功能，新增时任务可直接选择执行器
5. 优化 `doMap` 注释与异常处理逻辑

**工作流能力增强**

1. 支持任务指定时间点触发（时间点调度）
2. 增加负责人配置

**客户端能力增强**

1. 客户端注册支持展示系统版本和客户端类型(JAVA、GO、PYTHON)
2. 客户端新增标签配置
3. 客户端支持动态上下线能力
4. 支持在线编辑、删除、更新标签能力
5. 优化使用无锁化优化滑动窗口性能及稳定性

**其他**
1. 优化实例管理(节点注册、探活、故障转移、下线、节点过滤等)

**问题修复**

* 修复重试幂等 ID 重复问题（`SimpleIdempotentIdGenerate`）

标签配置: https://snailjob.opensnail.com/docs/guide/client/java/client.html
**MYSQL变更(其他DB变更请自行同步)**

> 全量的SQL请参考项目 /doc/sql/x.sql
```mysql
alter table sj_job
   add labels varchar(512) default '' null comment '标签';

CREATE TABLE `sj_job_executor`
(
   `id`            bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
   `namespace_id`  varchar(64)         NOT NULL DEFAULT '764d604ec6fc45f68cd92514c40e9e1a' COMMENT '命名空间id',
   `group_name`    varchar(64)         NOT NULL COMMENT '组名称',
   `executor_info` varchar(256)        NOT NULL COMMENT '任务执行器名称',
   `executor_type` varchar(3)          NOT NULL COMMENT '1:java 2:python 3:go',
   `create_dt`     datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
   `update_dt`     datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
   PRIMARY KEY (`id`),
   KEY `idx_namespace_id_group_name` (`namespace_id`, `group_name`),
   KEY `idx_create_dt` (`create_dt`)
) ENGINE = InnoDB
  AUTO_INCREMENT = 0
  DEFAULT CHARSET = utf8mb4 COMMENT ='任务执行器信息';

alter table sj_retry
   add serializer_name varchar(32) default 'jackson' not null comment '执行方法参数序列化器名称';

alter table sj_retry_dead_letter
   add serializer_name varchar(32) default 'jackson' not null comment '执行方法参数序列化器名称';

alter table sj_retry_scene_config
   add owner_id bigint                  null comment '负责人id',
   add labels   varchar(512) default '' null comment '标签'
;

drop table sj_sequence_alloc;

alter table sj_server_node
   add labels varchar(512) default '' null comment '标签';

alter table sj_workflow
   add owner_id bigint null comment '负责人id';

```

最后提交信息为： feat(1.6.0-beta1): 解决推送maven仓库失败问题

vsj1.5.0

0f37939

2025-05-18 20:36

Snail Job 1.5.0

最后提交信息为： feat(master): 发布1.5.0

vsj1.5.0-beta1

7d19959

2025-04-26 22:56

Snail Job 1.5-beta1

# 更新日志
1. 增加 WebSocket 实时获取重试任务和定时任务日志【新增】
2. 重试新增OpenApi支持查询重试任务、触发、状态更新【新增】
3. 定时任务支持通过名称模糊查询【新增】
4. 死信表新增 groupId 和 sceneId 字段【新增】
5. 重试任务支持"防止任务重复拉取"配置【新增】
6. 增加重试任务列表更新时间字段【新增】
7. 回滚死信表数据时支持异常明确提示（存在重复数据）【新增】
8. 内置 HTTP 执行器支持自定义响应结果判断【新增】
9. GitHub Action 构建优化，支持 arm64 镜像 【优化】
10. 修复重试次数传播机制错误问题【BUG】
11. 修复 CVE 漏洞并移除 log4j 【BUG】
12. 修复随机等待退避策略的时间单位转换错误【BUG】
13. 重构 RPC 命名结构，方便后续扩展【优化】
14. 翻译系统中文字符串为英文【优化】
15. 新增ES、Mongo日志存储插件【新增】
16. 新增SSO登录插件【新增】
17. 优化SQL性能 【优化】
18. 修复重试序列化LocalDateTime失败问题【BUG】
19. 修复滑动窗口上报窗口时间错误【BUG】
20. 优化重试任务列表和死信列表查询按钮显示问题 【优化】
21. 重试任务列表增加更新时间 2.修复重试列表更新时间title【优化】
22. 修复场景阻塞策略错误问题【BUG】
23. 重试任务达到最大重试次数后可以手动执行【优化】
24. 优化重试列表更多按钮的下拉框样式【优化】

**注意**
本次重点重构了重试模块的流程，由之前的同步调度客户端改为异步调度客户端. 将支持更高并发的调度同时大大提高服务端的稳定性

**MYSQL变更(其他DB变更请自行同步)**

> 全量的SQL请参考项目 /doc/sql/x.sql
```mysql
alter table sj_retry_dead_letter
    add group_id bigint not null comment '组Id' after group_name;

alter table sj_retry_dead_letter
    add scene_id bigint not null comment '场景ID' after scene_name;

alter table sj_retry
    add group_id bigint not null comment '组Id' after group_name;

alter table sj_retry
    add scene_id bigint not null comment '场景ID' after scene_name;

drop index idx_namespace_id_group_name_retry_status on sj_retry;

drop index idx_namespace_id_group_name_scene_name on sj_retry;

create index idx_retry_status_bucket_index
    on sj_retry (retry_status, bucket_index);

alter table sj_retry
    drop key uk_name_task_type_idempotent_id_deleted;

alter table sj_retry
    add constraint uk_scene_tasktype_idempotentid_deleted
        unique (scene_id, task_type, idempotent_id, deleted);
```

最后提交信息为： feat(master): 发布1.5.0-beta1

vsj1.4.0

e98771c

2025-03-23 22:20

Snail Job 1.4.0

最后提交信息为： feat(1.4.0): 客户端和服务端RPC默认使用GRPC

vsj1.4.0-beta2

38a8e43

2025-03-15 11:31

Snail Job 1.4.0-beta2

最后提交信息为： feat(1.4.0-beta2): 日志默认改为7天

vsj1.4.0-beta1

32fbe90

2025-03-02 10:54

Snail Job 1.4.0-beta1

1. sdk手动触发调用时，支持传递临时参数【优化】
2. oracle sql 索引名过长 【BUG】
3. 默认rpc-type: grpc【新增】
4. 场景添加回调配置 【新增】
5. Converter移入convert包【优化】
6. 添加 @EqualsAndHashCode(callSuper=true) 去除warning 【优化】
7. 消除 client-starter 依赖冲突(error_prone_annotations)【优化】
8. 消除 server-starter 依赖冲突(checker-qual,error_prone_annotations)【优化】
9. 优化maven结构，根pom统一管理版本【优化】
10. 修复定时任务触发常驻任务时，通过任务开关无法正常关闭定时任务问题 【BUG】
11. 修复了oracle数据库更新定时任务状态失败问题【BUG】
12. 修复代码编辑器格式化问题【BUG】
13. 修复周期性cron问题【BUG】
14. 重试模块服务端重构【新增】
   - sj_retry_task_0 改为 sj_retry
   - sj_retry_dead_letter_0 改为 sj_retry_dead_letter
   - sj_retry_task_log 改为 sj_retry_task_log

**注意**
本次重点重构了重试模块的流程，由之前的同步调度客户端改为异步调度客户端. 将支持更高并发的调度同时大大提高服务端的稳定性

**MYSQL变更(其他DB变更请自行同步)**

> 全量的SQL请参考项目 /doc/sql/x.sql
```mysql
ALTER TABLE `sj_group_config` DROP COLUMN `bucket_index`;

ALTER TABLE `sj_job` MODIFY COLUMN `block_strategy` tinyint(4) NOT NULL DEFAULT 1 COMMENT '阻塞策略 1、丢弃 2、覆盖 3、并行 4、恢复';

ALTER TABLE `sj_retry_scene_config` ADD COLUMN `block_strategy` tinyint(4) NOT NULL DEFAULT 1 COMMENT '阻塞策略 1、丢弃 2、覆盖 3、并行' AFTER `route_key`;
ALTER TABLE `sj_retry_scene_config` ADD COLUMN `cb_status` tinyint(4) NOT NULL DEFAULT 0 COMMENT '回调状态 0、不开启 1、开启' AFTER `block_strategy`;
ALTER TABLE `sj_retry_scene_config` ADD COLUMN `cb_trigger_type` tinyint(4) NOT NULL DEFAULT 1 COMMENT '1、默认等级 2、固定间隔时间 3、CRON 表达式' AFTER `cb_status`;
ALTER TABLE `sj_retry_scene_config` ADD COLUMN `cb_max_count` int(11) NOT NULL DEFAULT 16 COMMENT '回调的最大执行次数' AFTER `cb_trigger_type`;
ALTER TABLE `sj_retry_scene_config` ADD COLUMN `cb_trigger_interval` varchar(16) NOT NULL DEFAULT '' COMMENT '回调的最大执行次数' AFTER `cb_max_count`;

ALTER TABLE `sj_retry_task_log_message` DROP COLUMN `unique_id`;
ALTER TABLE `sj_retry_task_log_message` ADD COLUMN `retry_id` bigint(20) NOT NULL COMMENT '重试信息Id' AFTER `group_name`;
ALTER TABLE `sj_retry_task_log_message` ADD COLUMN `retry_task_id` bigint(20) NOT NULL COMMENT '重试任务Id' AFTER `retry_id`;

CREATE INDEX idx_namespace_id_group_name_retry_task_id ON sj_retry_task_log_message (`namespace_id`, `group_name`, `retry_task_id`);
ALTER TABLE sj_retry_task_log_message DROP INDEX idx_namespace_id_group_name_scene_name;

CREATE TABLE `sj_retry_dead_letter`
(
   `id`            bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
   `namespace_id`  varchar(64)         NOT NULL DEFAULT '764d604ec6fc45f68cd92514c40e9e1a' COMMENT '命名空间id',
   `group_name`    varchar(64)         NOT NULL COMMENT '组名称',
   `scene_name`    varchar(64)         NOT NULL COMMENT '场景名称',
   `idempotent_id` varchar(64)         NOT NULL COMMENT '幂等id',
   `biz_no`        varchar(64)         NOT NULL DEFAULT '' COMMENT '业务编号',
   `executor_name` varchar(512)        NOT NULL DEFAULT '' COMMENT '执行器名称',
   `args_str`      text                NOT NULL COMMENT '执行方法参数',
   `ext_attrs`     text                NOT NULL COMMENT '扩展字段',
   `create_dt`     datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
   PRIMARY KEY (`id`),
   KEY `idx_namespace_id_group_name_scene_name` (`namespace_id`, `group_name`, `scene_name`),
   KEY `idx_idempotent_id` (`idempotent_id`),
   KEY `idx_biz_no` (`biz_no`),
   KEY `idx_create_dt` (`create_dt`)
) ENGINE = InnoDB
  AUTO_INCREMENT = 0
  DEFAULT CHARSET = utf8mb4 COMMENT ='死信队列表'
;

CREATE TABLE `sj_retry`
(
   `id`              bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
   `namespace_id`    varchar(64)         NOT NULL DEFAULT '764d604ec6fc45f68cd92514c40e9e1a' COMMENT '命名空间id',
   `group_name`      varchar(64)         NOT NULL COMMENT '组名称',
   `scene_name`      varchar(64)         NOT NULL COMMENT '场景名称',
   `idempotent_id`   varchar(64)         NOT NULL COMMENT '幂等id',
   `biz_no`          varchar(64)         NOT NULL DEFAULT '' COMMENT '业务编号',
   `executor_name`   varchar(512)        NOT NULL DEFAULT '' COMMENT '执行器名称',
   `args_str`        text                NOT NULL COMMENT '执行方法参数',
   `ext_attrs`       text                NOT NULL COMMENT '扩展字段',
   `next_trigger_at` bigint(13)          NOT NULL COMMENT '下次触发时间',
   `retry_count`     int(11)             NOT NULL DEFAULT 0 COMMENT '重试次数',
   `retry_status`    tinyint(4)          NOT NULL DEFAULT 0 COMMENT '重试状态 0、重试中 1、成功 2、最大重试次数',
   `task_type`       tinyint(4)          NOT NULL DEFAULT 1 COMMENT '任务类型 1、重试数据 2、回调数据',
   `bucket_index`    int(11)             NOT NULL DEFAULT 0 COMMENT 'bucket',
   `parent_id`       bigint(20)          NOT NULL DEFAULT 0 COMMENT '父节点id',
   `deleted`         bigint(20)          NOT NULL DEFAULT 0 COMMENT '逻辑删除',
   `create_dt`       datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
   `update_dt`       datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
   PRIMARY KEY (`id`),
   KEY `idx_namespace_id_group_name_scene_name` (`namespace_id`, `group_name`, `scene_name`),
   KEY `idx_namespace_id_group_name_retry_status` (`namespace_id`, `group_name`, `retry_status`),
   KEY `idx_idempotent_id` (`idempotent_id`),
   KEY `idx_biz_no` (`biz_no`),
   KEY `idx_parent_id` (`parent_id`),
   KEY `idx_create_dt` (`create_dt`),
   UNIQUE KEY `uk_name_task_type_idempotent_id_deleted` (`namespace_id`, `group_name`, `task_type`, `idempotent_id`, `deleted`)
) ENGINE = InnoDB
  AUTO_INCREMENT = 0
  DEFAULT CHARSET = utf8mb4 COMMENT ='重试信息表'
;

CREATE TABLE `sj_retry_task`
(
   `id`               bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
   `namespace_id`     varchar(64)         NOT NULL DEFAULT '764d604ec6fc45f68cd92514c40e9e1a' COMMENT '命名空间id',
   `group_name`       varchar(64)         NOT NULL COMMENT '组名称',
   `scene_name`       varchar(64)         NOT NULL COMMENT '场景名称',
   `retry_id`         bigint(20)          NOT NULL COMMENT '重试信息Id',
   `ext_attrs`        text                NOT NULL COMMENT '扩展字段',
   `task_status`      tinyint(4)          NOT NULL DEFAULT 1 COMMENT '重试状态',
   `task_type`        tinyint(4)          NOT NULL DEFAULT 1 COMMENT '任务类型 1、重试数据 2、回调数据',
   `operation_reason` tinyint(4)          NOT NULL DEFAULT 0 COMMENT '操作原因',
   `client_info`      varchar(128)        DEFAULT NULL COMMENT '客户端地址 clientId#ip:port',
   `create_dt`        datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
   `update_dt`        datetime            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
   PRIMARY KEY (`id`),
   KEY `idx_group_name_scene_name` (`namespace_id`, `group_name`, `scene_name`),
   KEY `task_status` (`task_status`),
   KEY `idx_create_dt` (`create_dt`),
   KEY `idx_retry_id` (`retry_id`)
) ENGINE = InnoDB
  AUTO_INCREMENT = 0
  DEFAULT CHARSET = utf8mb4 COMMENT ='重试任务表'
;

DROP TABLE sj_retry_dead_letter_0;
DROP TABLE sj_retry_task_0;
DROP TABLE sj_retry_task_log;

```

最后提交信息为： feat(1.4.0-beta1): 前端打包

vsj1.3.0

4325ab3

2025-01-23 21:53

Snail Job 1.3.0

1. 新增Grpc通讯模块【新增】
2. 修改服务端默认端口号为17888【优化】
3. 设置客户端client为-1时，支持随机端口号【新增】
4. 邮箱通知添加额外的自定义属性【新增】
5. 增加删除功能OpenApi【新增】
6. isRetry改为retryStatus 【优化】
7. 将内置执行器移入builtin包【优化】
8. 调整客户端注册逻辑；使用主节点模式对客户端进行续签【优化】
9. 优化重试场景、定时任务、工作流告警通知配置【优化】
10. 手动执行任务/工作流支持传入临时参数【新增】
11. 定时任务新增负责人选项【新增】
12. 定时任务增加执行器信息搜索条件【新增】
13. 支持无客户端时告警功能【新增】
14. 客户执行失败支持显示失败原因【新增】
15. 新增GRPC重连事件【新增】
16. 负责人支持清除【新增】
17. 优化cron表达式解析错误异常信息

**注意**
本次新增了Grpc协议,后续计划逐渐废弃Netty请大家尽快切换
```
snail-job.rpc-type=grpc
```

**MYSQL变更(其他DB变更请自行同步)**

> 全量的SQL请参考项目 /doc/sql/x.sql
```mysql
ALTER TABLE `sj_notify_config`
   ADD COLUMN `notify_name` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '通知名称',
   DROP COLUMN `business_id`;

ALTER TABLE `sj_job`
   ADD COLUMN `notify_ids` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '通知告警场景配置id列表',
   ADD COLUMN `owner_id`   bigint(20)   NULL COMMENT '负责人id';

ALTER TABLE `sj_retry_scene_config`
   ADD COLUMN `notify_ids` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '通知告警场景配置id列表';

ALTER TABLE `sj_workflow`
   ADD COLUMN `notify_ids` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '通知告警场景配置id列表';

```

最后提交信息为： feat(1.3.0): 发布1.3.0正式版本