Quartz触发后台作业报错：relation 'qrtz_job_details'不存在

核心排查方向 #

• 架构（Schema）不匹配：PostgreSQL默认使用public架构，若你的qrtz_job_details表存在于其他架构（如quartz），Quartz会默认到public下查找，导致找不到表。
• 表名大小写冲突：PostgreSQL对标识符大小写敏感，若建表时用了大写（如QRTZ_JOB_DETAILS），但Quartz默认以小写查询，就会抛出不存在的错误。
• 连接字符串未配置搜索路径：连接字符串未指定SearchPath，数据库无法定位到目标架构下的表。
• Quartz配置未关联正确的数据库上下文参数：虽然添加了DbContext，但Quartz持久化的独立连接可能和DbContext的连接配置存在差异（如架构、搜索路径）。

代码修正示例 #

1. 指定表所在架构 #

如果表在非public架构下，直接在Quartz的PostgreSQL配置中指定架构：

builder.Services.AddQuartz(q =>
{
    q.UseMicrosoftDependencyInjectionJobFactory();
    q.UsePersistentStore(s =>
    {
        s.UsePostgres(options =>
        {
            options.ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection");
            // 替换为你的表实际所在架构
            options.Schema = "quartz";
        });
        s.UseJsonSerializer();
        s.PerformSchemaValidation = false;
    });
});

2. 调整连接字符串（添加搜索路径） #

在appsettings.json的连接字符串中加入SearchPath，指定数据库需要搜索的架构顺序：

"ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=your_db;Username=your_user;Password=your_pass;SearchPath=quartz,public"
}

3. 适配大写表名 #

若你的Quartz表是大写命名（如QRTZ_JOB_DETAILS），开启Quartz的引号标识符支持，强制使用精确表名查询：

builder.Services.AddQuartz(q =>
{
    q.UseMicrosoftDependencyInjectionJobFactory();
    q.UsePersistentStore(s =>
    {
        s.UsePostgres(options =>
        {
            options.ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection");
            // 启用引号包裹标识符，适配大小写敏感的表名
            options.UseQuotedIdentifiers = true;
        });
        s.UseJsonSerializer();
        s.PerformSchemaValidation = false;
    });
});

额外验证步骤 #

• 确认数据库用户拥有目标表的读写权限，执行授权语句：

  GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA your_schema TO your_db_user;
  

• 检查Quartz与Npgsql版本兼容性（Quartz 3.x建议搭配Npgsql 6.0+）
• 暂时开启PerformSchemaValidation = true，查看更详细的表结构校验错误，帮助定位问题

内容的提问来源于stack exchange，提问作者K V V NAIDU