Skip to content
功能模块

系统配置

系统配置设置服务标识、停机与中断恢复策略,并提供文件与四种数据库之间的可视化数据迁移。

更新于 2026-11-17MIT 开源

系统配置 ​

系统配置页用于三件事:区分多实例、配置停机与恢复策略、迁移存储数据。页面顶部提供「停机与恢复 / 数据迁移」分区切换。

1. 服务标识 ​

配置项说明示例
服务名称当前调度服务的名称,同时用于浏览器标题order-center-job
环境标识DEV / TEST / UAT / PRODPROD
服务描述补充说明,分析页顶部展示订单中心定时任务

配置保存在存储层,会随数据迁移一起复制。多实例部署时应为每个实例设置可区分的名称与环境。

2. 停机与恢复 ​

v2.7.0 新增的启动期配置。保存后需重启应用才生效;与当前进程实际生效值有差异时,页面提示「重启后生效 N 项」,可展开对比旧值与新值。

v2.7.1 起,分区标题右侧提供「恢复默认」。该按钮只还原表单,仍需保存后落库。

2.1 停机 ​

配置项默认值说明
停机模式排水后停止立即停止 / 排水后停止
排水超时(秒)60排水模式下最多等待时间,超时后未完成执行被标记为中断

「等待完成超时」是旧版本字段,已并入「排水后停止」,不再在界面单独配置。

应用关闭时的等待还受宿主 HostOptions.ShutdownTimeout(默认 30 秒)约束,希望等待更久时需同步调大。

2.2 中断恢复 ​

配置项默认值说明
启用中断补偿开启关闭后不补跑,启动时也不扫描中断、不弹恢复提示;遗留的运行中记录仍由心跳标记为中断
补偿延迟(秒)30启动后延迟多久开始补偿
心跳间隔(秒)15执行中任务写心跳的周期
租约时长(秒)60超过该时长未续期即判定中断,必须 ≥ 2 × 心跳间隔
临近触发跳过阈值(秒)120距下次触发不足该秒数时跳过补偿
补偿策略每个作业补最近一次只标记不补偿 / 补最近一次 / 全部补偿
最大执行次数3同一执行链最多执行到第几次,含原执行
默认允许中断补跑开启作业未单独配置时的默认值
中断日志保留(天)30中断与补偿链日志保留;0 跟随普通日志策略

保存时服务端校验:

  • 取值范围;
  • 「租约 ≥ 2 × 心跳」;
  • 选择「全部补偿」时二次确认。

完整语义见 中断恢复与排水调度。

3. 数据迁移 ​

系统配置页提供可视化迁移入口,支持文件与 MySQL / PostgreSQL / SQLite / SQL Server 之间互转。

3.1 操作流程 ​

  1. 卡片展示当前存储类型;
  2. 选择源存储与目标存储(仅一种可用存储时给出空状态提示);
  3. 预检数据量,查看预计插入 / 更新 / 跳过数量;
  4. 选择写入模式与迁移内容(作业、日志、系统设置、通知);
  5. 执行迁移,通过「查看摘要」查看进度与结果;
  6. 查看迁移后的配置建议。

数据迁移

3.2 三种写入模式 ​

模式语义
合并 Merge不存在则插入,存在则跳过
覆盖 Overwrite不存在则插入,存在则更新
替换 Replace先清空目标所选实体,再全量写入

Replace 默认不可用,需要在配置中开启 QuartzUI:Migration:AllowReplace,执行前仍会二次确认。

3.3 注意事项 ​

  • 迁移不会自动修改存储配置,完成后需手动改 StorageType、DatabaseProvider 与连接字符串并重启;
  • 文件源会自动备份,数据库源不会,迁移前请自行备份;
  • 目标数据库会自动建表并应用迁移;
  • 迁移后做数量校验与抽样比对,差异只告警不阻断;
  • 连接字符串只保存在服务端,不会下发到浏览器。

完整说明见 数据迁移。

4. 配置存储 ​

存储位置
文件setting.json
数据库quartz_settings 表

与 appsettings.json 的区别

appsettings.json 的 QuartzUI 节负责启动参数(存储、JWT、账号密码等);系统配置页负责运行期业务配置(服务标识、停机与恢复策略等)。两者互不覆盖。

让 Quartz.Net 调度,从未如此简单