.NET EF 如何为开发/生产环境配置独立的数据库提供程序

针对开发环境用Sqlite、生产环境用SqlServer的场景，以下是3种经过验证的可行方案：

方案1：为不同数据库单独维护迁移集合（官方推荐） #

EF Core原生支持为不同的数据库提供程序生成独立的迁移，操作步骤如下：

• 在项目中创建分数据库的迁移存储目录，例如Migrations/Sqlite、Migrations/SqlServer
• 每次新增迁移时，分别为两个数据库生成对应迁移文件，命令如下：

  Package Manager Console：
  Sqlite迁移生成：Add-Migration {迁移名称} -Context AppDbContext -OutputDir Migrations/Sqlite
  SqlServer迁移生成：Add-Migration {迁移名称} -Context AppDbContext -OutputDir Migrations/SqlServer

  Dotnet CLI：
  Sqlite迁移生成：dotnet ef migrations add {迁移名称} --context AppDbContext --output-dir Migrations/Sqlite
  SqlServer迁移生成：dotnet ef migrations add {迁移名称} --context AppDbContext --output-dir Migrations/SqlServer

• 服务注册时根据环境切换数据库提供程序，示例代码：

var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");

builder.Services.AddDbContext<AppDbContext>(options =>
{
    if (builder.Environment.IsDevelopment())
    {
        options.UseSqlite(connectionString, opt => 
            opt.MigrationsAssembly(typeof(AppDbContext).Assembly.FullName));
    }
    else
    {
        options.UseSqlServer(connectionString, opt => 
            opt.MigrationsAssembly(typeof(AppDbContext).Assembly.FullName));
    }
});

• 如果需要针对不同数据库做特殊的模型配置，可以在OnModelCreating方法中加条件判断：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    if (Database.IsSqlServer())
    {
        // 配置SqlServer特有逻辑，比如字段类型、索引规则等
    }
    else if (Database.IsSqlite())
    {
        // 配置Sqlite特有逻辑
    }
}

该方案的优势是可以完全复用EF Core自动迁移的能力，改动成本低，仅需要每次生成迁移时执行两次命令即可。

方案2：手动维护SQL升级脚本 #

如果不想依赖EF Core的自动迁移，可以选择手动管理升级脚本：

• 放弃EF Core自动迁移能力，手动编写SQL脚本，通用逻辑可以写一套兼容脚本，差异逻辑分别编写Sqlite、SqlServer专属脚本
• 可以搭配FluentMigrator等迁移工具实现按环境执行对应脚本，也可以自己实现简单的脚本执行逻辑，应用启动时根据当前环境执行对应升级脚本
  该方案的优势是对迁移逻辑完全可控，不会出现框架自动生成SQL的兼容问题，劣势是需要手动维护所有脚本，开发成本更高。

方案3：统一开发与生产的数据库类型（最优成本方案） #

如果不想维护两套迁移逻辑，可以直接在开发环境用Docker启动轻量SqlServer实例，和生产环境保持完全一致，从根源上避免迁移冲突：

• 本地安装Docker后，执行命令即可快速启动SqlServer实例：docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=YourStrong@Passw0rd" -p 1433:1433 --name local-sqlserver -d mcr.microsoft.com/mssql/server:latest
• 开发环境连接本地Docker运行的SqlServer，不需要做任何迁移兼容处理，和生产环境完全对齐
  该方案适合大部分业务场景，额外维护成本极低，是投入产出比最高的选择。

通用注意事项 #

• 尽量避免使用特定数据库独有的语法特性，减少兼容成本
• 每次发布前必须在和生产一致的测试环境执行迁移验证，避免生产升级失败

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