.NET Aspire中多DbContext配置及兼容非Aspire生产环境的实现问题

我刚好碰到过类似的场景，给你分享一个能兼顾.NET Aspire开发环境和非Aspire生产环境的多DbContext配置方案，还能完美实现每个DbContext用不同schema存储迁移历史表的需求。

核心思路 #

关键是区分Aspire和非Aspire环境的注册逻辑，同时把通用的配置逻辑抽离出来，避免重复代码。我们可以通过配置开关来判断当前环境是否使用Aspire，然后分别用Aspire专属的AddSqlServerDbContext和常规的AddDbContext来注册上下文。

步骤1：定义带Schema的DbContext #

先给每个DbContext指定专属的schema，方便后续配置迁移历史表：

public class ContextA : DbContext
{
    public const string Schema = "schema_a";
    // 你的DbSet定义...
    
    public ContextA(DbContextOptions<ContextA> options) : base(options) { }
}

public class ContextB : DbContext
{
    public const string Schema = "schema_b";
    // 你的DbSet定义...
    
    public ContextB(DbContextOptions<ContextB> options) : base(options) { }
}

步骤2：配置环境开关 #

在appsettings.json里加一个开关，用来标记是否使用Aspire环境：

{
  "ConnectionStrings": {
    "ContextA": "你的生产环境连接字符串",
    "ContextB": "你的生产环境连接字符串"
  },
  "UseAspire": false
}

然后在Aspire的AppHost项目中，给你的API服务添加这个配置，确保Aspire环境下该值为true：

var api = builder.AddProject<Projects.YourApi>("yourapi")
    .WithConfiguration("UseAspire", true)
    .WithReference(yourSqlServerComponent);

步骤3：条件注册DbContext #

在API项目的Program.cs中，根据开关值选择不同的注册方式，同时抽离通用的配置逻辑：

var builder = WebApplication.CreateBuilder(args);
var useAspire = builder.Configuration.GetValue<bool>("UseAspire");

// 抽离通用的SqlServer配置逻辑
Action<DbContextOptionsBuilder> GetDbContextConfig(string connectionString)
{
    return options => options.UseSqlServer(connectionString);
}

// 抽离迁移历史表配置逻辑
Action<SqlServerDbContextOptionsBuilder> GetMigrationConfig(string schema)
{
    return sqlOpts => sqlOpts.MigrationsHistoryTable("__EFMigrationsHistory", schema);
}

if (useAspire)
{
    // Aspire环境：用AddSqlServerDbContext自动获取组件的连接字符串
    builder.Services.AddSqlServerDbContext<ContextA>(
        configureDbContext: GetDbContextConfig,
        configureSqlServer: GetMigrationConfig(ContextA.Schema));
    
    builder.Services.AddSqlServerDbContext<ContextB>(
        configureDbContext: GetDbContextConfig,
        configureSqlServer: GetMigrationConfig(ContextB.Schema));
}
else
{
    // 非Aspire环境：用常规AddDbContext从配置读取连接字符串
    builder.Services.AddDbContext<ContextA>(
        options => options.UseSqlServer(builder.Configuration.GetConnectionString("ContextA")),
        GetMigrationConfig(ContextA.Schema));
    
    builder.Services.AddDbContext<ContextB>(
        options => options.UseSqlServer(builder.Configuration.GetConnectionString("ContextB")),
        GetMigrationConfig(ContextB.Schema));
}

步骤4：迁移处理 #

Aspire环境下的迁移

在AppHost项目中，可以直接给数据库组件关联迁移，Aspire会自动处理：

var sqlServer = builder.AddSqlServer("yourdb")
    .WithDatabase("your_db_name")
    .WithMigration<ContextA>()
    .WithMigration<ContextB>();

非Aspire环境下的迁移

可以通过EF Core命令行手动执行：

# 给ContextA生成迁移
dotnet ef migrations add InitialCreate --context ContextA --output-dir Migrations/ContextA

# 给ContextB生成迁移
dotnet ef migrations add InitialCreate --context ContextB --output-dir Migrations/ContextB

# 执行迁移
dotnet ef database update --context ContextA
dotnet ef database update --context ContextB

注意事项 #

• 连接字符串命名：Aspire的AddSqlServerDbContext默认会查找与DbContext同名的连接字符串（比如ContextA对应ConnectionStrings:ContextA），所以在AppHost配置时要确保数据库引用的连接字符串名称匹配。
• 生产环境迁移：不建议在生产环境启用自动迁移（context.Database.Migrate()），最好通过CI/CD流程手动执行迁移，保证数据安全。
• 多DbContext共用数据库：如果多个DbContext指向同一个数据库，只要schema不同，迁移历史表就不会冲突，完全可以正常运行。

备注：内容来源于stack exchange，提问作者Vytenis Kajackas