构建 .NET 9 Quartz 可视化调度系统（使用 Chet.QuartzNet.UI）

在企业项目中，定时任务非常常见，比如 报表生成、数据同步、订单超时处理 等。Quartz.NET 是 .NET 生态最流行的任务调度框架，而 Chet.QuartzNet.UI 提供了一个现代化可视化界面，让开发者轻松管理任务和触发器。

本文展示如何在 .NET 9 项目中使用 Quartz 3.16.1 + Quartz.Extensions.Hosting + Chet.QuartzNet.UI 2.1.x 构建可视化调度系统。

一、项目依赖

在 .csproj 中添加 NuGet 包：

<ItemGroup>
<PackageReference Include="Chet.QuartzNet.UI" Version="2.1.1" />
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.12" />
<PackageReference Include="Quartz" Version="3.16.1" />
<PackageReference Include="Quartz.AspNetCore" Version="3.16.1" />
<PackageReference Include="Quartz.Extensions.Hosting" Version="3.16.1" />
</ItemGroup>

说明：

• Quartz 3.16.1：核心调度框架

• Quartz.AspNetCore：将 Quartz 集成到 ASP.NET Core

• Quartz.Extensions.Hosting：提供 HostedService 支持，应用启动时自动调度任务

• Chet.QuartzNet.UI 2.1.1：可视化管理界面

• Microsoft.AspNetCore.OpenApi：生成 Swagger API（可选）

二、Quartz UI 配置

在 appsettings.json 中添加 Quartz UI 配置：

{
"QuartzUI": {
"JwtSecret": "Y2V0aFF1YXJ6TmV0VUlBdXRoZW50aWNhdGlvblNlY3JldA==",
"JwtExpiresInMinutes": 60,
"JwtIssuer": "Chet.QuartzNet.UI",
"JwtAudience": "Chet.QuartzNet.UI",
"UserName": "Admin",
"Password": "123456"
},
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}

说明：

• JwtSecret：JWT 签名密钥

• JwtExpiresInMinutes：Token 有效期

• UserName / Password：Dashboard 登录账号

这样可以保证 Quartz UI 只允许认证用户访问。

三、创建 Job

Quartz 任务需要实现 IJob 接口：

using Quartz;

namespace QuartzDemo.Jobs;

public class HelloJob : IJob
{
private readonly ILogger<HelloJob> _logger;

public HelloJob(ILogger<HelloJob> logger)
{
_logger = logger;
}

public Task Execute(IJobExecutionContext context)
{
_logger.LogInformation($"HelloJob executed at {DateTime.Now}");
return Task.CompletedTask;
}
}

Execute 方法中放置定时任务逻辑，比如打印日志或调用业务接口。

四、Program.cs 配置 Quartz 和 UI

.NET 9 Minimal API 示例：

using Chet.QuartzNet.UI.Extensions;
using Quartz;
using QuartzDemo.Jobs;

var builder = WebApplication.CreateBuilder(args);

// 注册 Controllers 和 OpenAPI
builder.Services.AddControllers();
builder.Services.AddOpenApi();

// 注册 Quartz HostedService
builder.Services.AddQuartzHostedService();

// 注册 Quartz UI 服务
builder.Services.AddQuartzUI(builder.Configuration);

// 可选：自动扫描并注册所有 ClassJob
// builder.Services.AddQuartzClassJobs();

var app = builder.Build();

// 配置 OpenAPI（开发环境可用）
if (app.Environment.IsDevelopment())
{
app.MapOpenApi();
}

app.UseHttpsRedirection();
app.UseAuthorization();

// 映射 Controller
app.MapControllers();

// 挂载 Quartz UI
app.UseQuartz();

// 测试首页
app.MapGet("/", () => "Quartz Running");

app.Run();

说明

五、访问 Dashboard

启动项目后，浏览器访问：

https://localhost:5001/quartz-ui

登录界面使用：

• 用户名：Admin

• 密码：123456

Dashboard 功能：

• Scheduler 状态：Running / Standby / Shutdown

• Job 列表和 Trigger 配置

• 暂停 / 恢复任务

• 立即执行任务

• 查看任务执行日志（可选）

六、生产实践建议

使用数据库存储 Job 和 Trigger：

q.UsePersistentStore(x =>
{
x.UseSqlServer(builder.Configuration.GetConnectionString("QuartzDb"));
x.UseJsonSerializer();
});

支持 SQL Server、MySQL、PostgreSQL 等数据库。

多实例共享数据库，保证任务不重复执行：

API1 API2 API3
\\ | /
Quartz DB

通过 Dashboard 或自定义 API 可以动态添加、修改任务，无需重启应用。

七、总结

通过 Quartz 3.16.1 + Quartz.Extensions.Hosting + Chet.QuartzNet.UI 2.1.1，你可以在 .NET 9 项目中实现：

• 企业级定时任务调度

• Cron 定时触发

• 多 Job 管理

• 可视化 UI 管理（暂停 / 恢复 / 立即执行）

• JWT 安全登录

可以替代 Quartzmin，实现现代化、可管理、可扩展的企业级 Quartz 调度系统。