如何为开发/测试/生产多数据库实例使用单套EF Core迁移脚本？

核心思路 #

EF Core 是根据上下文类的类型划分迁移集合的，你之前创建三个不同的上下文类，自然会生成三套迁移。解决办法是只用一个上下文类，通过配置切换不同环境的连接字符串，这样模型唯一，迁移脚本也只会生成一套。

具体步骤 #

1. 重构上下文类

删除原来的三个具体上下文类（MyProductionContext、MyDevelopmentContext、MyTestingContext），只保留一个通用的上下文类（比如命名为AppDbContext），让它支持从配置读取连接字符串：

public class AppDbContext : DbContext
{
    private readonly IConfiguration _configuration;
    private readonly string _connStringName;

    // 用于EF迁移的构造函数
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
    {
    }

    // 用于依赖注入时指定连接字符串名称的构造函数
    public AppDbContext(IConfiguration configuration, string connStringName)
    {
        _configuration = configuration;
        _connStringName = connStringName;
    }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            // 从配置中读取指定名称的连接字符串
            optionsBuilder.UseSqlServer(_configuration.GetConnectionString(_connStringName));
        }
    }

    // 你的DbSet定义...
    // public DbSet<YourEntity> YourEntities { get; set; }
}

2. 配置多环境连接字符串

在appsettings.json（或对应环境的配置文件，如appsettings.Development.json）中配置三个环境的连接字符串：

{
  "ConnectionStrings": {
    "Development": "Server=dev-db;Database=DevDB;Trusted_Connection=True;",
    "Testing": "Server=test-db;Database=TestDB;Trusted_Connection=True;",
    "Production": "Server=prod-db;Database=ProdDB;Trusted_Connection=True;"
  }
}

3. 生成单套迁移脚本

只针对这个通用上下文生成迁移，命令如下：

dotnet ef migrations add AddSomeNewFields --context AppDbContext

此时只会在项目中生成一套迁移文件，对应唯一的数据模型。

4. 将迁移应用到不同数据库

有两种常用方式：

方式一：命令行直接指定连接字符串

# 应用到开发库
dotnet ef database update --context AppDbContext --connection "Server=dev-db;Database=DevDB;Trusted_Connection=True;"

# 应用到测试库
dotnet ef database update --context AppDbContext --connection "Server=test-db;Database=TestDB;Trusted_Connection=True;"

# 应用到生产库
dotnet ef database update --context AppDbContext --connection "Server=prod-db;Database=ProdDB;Trusted_Connection=True;"

方式二：通过环境变量切换配置

先设置当前环境变量，再执行更新命令：

# Windows系统
set ASPNETCORE_ENVIRONMENT=Development
dotnet ef database update --context AppDbContext

set ASPNETCORE_ENVIRONMENT=Testing
dotnet ef database update --context AppDbContext

set ASPNETCORE_ENVIRONMENT=Production
dotnet ef database update --context AppDbContext

# Linux/Mac系统
export ASPNETCORE_ENVIRONMENT=Development
dotnet ef database update --context AppDbContext

export ASPNETCORE_ENVIRONMENT=Testing
dotnet ef database update --context AppDbContext

export ASPNETCORE_ENVIRONMENT=Production
dotnet ef database update --context AppDbContext

额外说明 #

• 确保三个数据库的Schema完全一致：因为单套迁移脚本要求所有目标数据库的结构遵循同一模型，这也是多环境数据库的常规设计原则。
• 依赖注入时的上下文注册：如果是Web项目，可以在Program.cs中根据当前环境自动选择连接字符串：

var builder = WebApplication.CreateBuilder(args);
var env = builder.Environment;

builder.Services.AddDbContext<AppDbContext>(options =>
{
    var connStringName = env.IsProduction() ? "Production" : 
                         env.IsEnvironment("Testing") ? "Testing" : "Development";
    options.UseSqlServer(builder.Configuration.GetConnectionString(connStringName));
});

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