.NET 6中Quartz.NET用AdoJobStore(SQL Server)不生成作业记录问题

在.NET 6 API项目中集成Quartz.NET实现定时邮件通知时，内存存储模式功能正常，但切换为SQL Server的AdoJobStore后，JOB_DETAILS等核心表无数据写入，结合你提供的代码与配置，以下是最可能遗漏的关键环节：

1. 配置文件存在缺失或错误 #

• DriverDelegateType不完整：你的appsettings.json中quartz.jobStore.driverDelegateType值为"Quartz.Impl.....,Quartz"，这是无效的。SQL Server对应的正确值应为：

  "quartz.jobStore.driverDelegateType": "Quartz.Impl.AdoJobStore.SqlServerDelegate, Quartz"
  

  该委托类负责生成SQL Server兼容的数据库操作语句，缺失或错误会直接导致无法与数据库交互。
• 连接字符串为空：quartz.dataSource.quartzDataSource.connectionString未填写有效连接字符串，必须配置为可访问目标SQL Server的连接串，例如：

  "quartz.dataSource.quartzDataSource.connectionString": "Server=.;Database=QuartzDB;Trusted_Connection=True;TrustServerCertificate=True;"
  

• 属性存储校验：quartz.jobStore.useProperties设为true时，JobDataMap中的所有数据必须为字符串类型，虽然你的代码使用Dictionary<string, string>，但需确保无其他类型数据传入，否则会导致存储失败。

2. 未创建Quartz所需的系统表 #

AdoJobStore依赖预先创建的数据库表，SQL Server对应的建表脚本可在Quartz的NuGet包（Quartz/lib/net6.0/quartz_sqlserver.sql）或源码中获取。需确保与tablePrefix（你设置的tbl_sched_）匹配的表（如tbl_sched_JOB_DETAILS、tbl_sched_TRIGGERS等）已在目标数据库中创建，且应用程序账户拥有读写权限。

3. 服务注册存在冲突 #

你的program.cs中同时使用builder.Services.AddQuartz()和手动注册ISchedulerFactory为StdSchedulerFactory，这会导致配置加载冲突。AddQuartz()已自动完成ISchedulerFactory的注册与QuartzOptions绑定，手动重复注册会覆盖配置，导致AdoJobStore设置未生效。建议移除手动注册的ISchedulerFactory，改用AddQuartz的链式配置更可靠：

builder.Services.AddQuartz(configure =>
{
    configure.UseMicrosoftDependencyInjectionJobFactory();
    configure.SchedulerName("MySchedulerLocal");
    configure.UsePersistentStore(store =>
    {
        store.UseSqlServer(sql =>
        {
            sql.ConnectionString = builder.Configuration.GetSection("Quartz:quartz.dataSource.quartzDataSource.connectionString").Value;
            sql.TablePrefix = "tbl_sched_";
        });
        store.UseProperties = true;
        store.MisfireThreshold = TimeSpan.FromMinutes(7);
    });
});

4. Job调度逻辑的潜在问题 #

• Scheduler实例不统一：CreateJobTrigger方法中每次调用_schedulerFactory.GetScheduler()获取新实例，而非使用StartAsync中初始化的Scheduler属性，可能导致新实例未加载AdoJobStore配置。应统一使用类内的Scheduler实例。
• 异步调用不规范：代码混合使用Wait()和await（如Sched.GetTrigger(...).Result），易引发死锁或异步流程异常，需全部改为await调用：

  var existingTrigger = await Sched.GetTrigger(new TriggerKey(triggerName!, groupName!));
  // ...
  await Sched.UnscheduleJob(new TriggerKey(triggerName!, groupName!));
  

• 日志格式化错误：异常日志的参数写法错误，应改为：

  _logger.LogError(ex, "Error while creating job");
  

  确保异常详情被正确记录，便于排查。

5. 数据库权限与连接验证 #

• 确认应用程序运行身份（如IIS应用池账户、控制台运行账户）拥有目标SQL Server数据库的读写权限。
• 单独测试连接字符串有效性，排除网络、防火墙或账户权限问题。

内容的提问来源于stack exchange，提问作者gjo