求助：.NET 6中Hangfire+PostgreSQL访问仪表盘报42601语法错误

问题背景 #

在.NET 6环境中使用Hangfire结合PostgreSQL存储，安装Hangfire.PostgreSql 1.9.10版本，配置代码及连接字符串如下：

Program.cs 配置代码 #

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddHangfire(config => config.UsePostgreSqlStorage(builder.Configuration.GetConnectionString("HangfireConnection")));
builder.Services.AddHangfireServer();

var app = builder.Build();

app.UseHangfireDashboard();

连接字符串（appsettings.json） #

"ConnectionStrings": {
  "HangfireConnection": "Host=db1.motorazmasamin.com;Port=***;Database=Hangfire;Username=***;Password=***"
}

访问仪表盘http://localhost/hangfire时，返回500错误：

{"data":null,"status":-1,"message":"42601: syntax error at or near "value"\r\n\r\nPOSITION: 59","statusCode":"500"}

切换为SQL Server+Hangfire.SqlServer包时功能正常。

解决方案 #

1. 检查PostgreSQL服务器版本兼容性 #

Hangfire.PostgreSql 1.9.x版本要求PostgreSQL服务器版本不低于10.0，若服务器版本低于此标准，会因不支持部分SQL语法（如VALUES子句的特定用法）触发该错误。

• 执行SQL查询确认服务器版本：

SELECT version();

若版本低于10.0，需升级PostgreSQL服务器，或降级Hangfire.PostgreSql到兼容旧版本的分支（不推荐）。

2. 显式指定Hangfire Schema并确保权限 #

默认情况下Hangfire使用public Schema，部分环境下可能存在权限或命名冲突，显式指定专属Schema可规避此类问题：

修改Program.cs中的配置：

builder.Services.AddHangfire(config => 
    config.UsePostgreSqlStorage(
        builder.Configuration.GetConnectionString("HangfireConnection"),
        new PostgreSqlStorageOptions
        {
            SchemaName = "hangfire" // 指定专属Schema
        }));

• 确保数据库用户拥有创建Schema、表的权限，若权限不足，可手动创建Schema：

CREATE SCHEMA IF NOT EXISTS hangfire;

3. 升级Hangfire.PostgreSql版本 #

1.9.10为较旧版本，存在已知语法兼容问题，建议升级到最新稳定版（如2.x系列）：

• 在NuGet包管理器中更新Hangfire.PostgreSql到最新版本
• 升级后重新运行应用，Hangfire会自动更新数据库结构

4. 验证连接字符串与服务器访问权限 #

确认连接字符串中的端口、用户名、密码正确，同时检查PostgreSQL服务器是否允许当前应用服务器的IP访问（需排查防火墙规则、pg_hba.conf配置）。

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