如何在配置Hangfire服务前通过EF Core程序化创建数据库？

我使用Hangfire处理定时任务，但Hangfire依赖已存在的数据库才能正常运行。尝试通过DbContext或WebApplication创建的ServiceScope执行数据库迁移，但在配置Hangfire服务的步骤中仍会抛出异常。请问如何在添加Hangfire服务前，通过EF Core程序化创建数据库？

当前添加Hangfire的代码 #

builder.Services.AddHangfire(x => x
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UsePostgreSqlStorage(builder.Configuration["HangfireConnection"]));
builder.Services.AddHangfireServer(options =>
{
    options.WorkerCount = 10;
});

无效的尝试方法 #

方法1：在DbContext构造函数中执行Migrate #

public TestDbContext(DbContextOptions<TestDbContext> options) : base(options) 
{
    Database.Migrate();
}

方法2：在DbContext构造函数中执行EnsureCreated #

public TestDbContext(DbContextOptions<TestDbContext> options) : base(options) 
{
    Database.EnsureCreated();
}

方法3：通过WebApplication的ServiceScope执行EnsureCreated #

using (var scope = app.Services.CreateScope())
{
    var context = scope.ServiceProvider.GetRequiredService<TestDbContext>();
    context.Database.EnsureCreated();
}

方法4：通过WebApplication的ServiceScope执行Migrate #

using (var scope = app.Services.CreateScope())
{
    var context = scope.ServiceProvider.GetRequiredService<TestDbContext>();
    context.Database.Migrate();
}

解决方案 #

核心思路是在配置Hangfire服务之前，手动创建DbContext实例并完成数据库初始化，不依赖尚未完全就绪的DI容器。具体代码如下：

// 1. 从配置中获取数据库连接字符串
var dbConnectionString = builder.Configuration.GetConnectionString("YourDbConnection");

// 2. 手动构建DbContext配置选项
var dbContextOptions = new DbContextOptionsBuilder<TestDbContext>()
    .UseNpgsql(dbConnectionString) // 适配PostgreSQL，若用其他数据库替换为对应方法（如UseSqlServer）
    .Options;

// 3. 创建DbContext实例并执行数据库初始化
using (var dbContext = new TestDbContext(dbContextOptions))
{
    dbContext.Database.Migrate(); // 若不需要迁移，可替换为 dbContext.Database.EnsureCreated()
}

// 4. 此时数据库已就绪，再配置Hangfire服务
builder.Services.AddHangfire(x => x
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UsePostgreSqlStorage(builder.Configuration["HangfireConnection"]));
builder.Services.AddHangfireServer(options =>
{
    options.WorkerCount = 10;
});

为什么之前的方法无效？ #

• DbContext构造函数中执行初始化：DI容器初始化阶段，Hangfire配置可能提前触发DbContext创建，此时数据库尚未完成初始化，导致异常。
• WebApplication的ServiceScope执行初始化：该操作是在WebApplication构建完成后执行，晚于Hangfire的配置步骤，无法满足Hangfire对已存在数据库的依赖要求。

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