EF Core数据库优先模式下，开发与生产多数据库及模型差异处理最佳实践

1. 多环境连接字符串隔离 #

用环境专属配置文件区分开发与基准数据库的连接字符串，无需手动切换：

• 在appsettings.json中配置基准（生产/外部管控）数据库的连接字符串
• 在appsettings.Development.json中覆盖为开发数据库的连接字符串，Rider会根据运行环境自动加载对应配置

示例配置：

// appsettings.json
{
  "ConnectionStrings": {
    "MainDb": "Server=tcp:xxx.database.windows.net...;Initial Catalog=ProductionDb;"
  }
}

// appsettings.Development.json
{
  "ConnectionStrings": {
    "MainDb": "Server=tcp:dev-xxx.database.windows.net...;Initial Catalog=DevDb;"
  }
}

2. 模型差异的隔离管理 #

针对外部架构变更与开发库的模型差异，推荐两种可行方案：

方案A：按数据库拆分模型目录 #

将不同数据库的模型分别放入独立子目录，避免文件冲突：

• 生成基准库模型（外部变更后执行）：

Scaffold-DbContext "Server=tcp:xxx.database.windows.net...;Initial Catalog=ProductionDb;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models/Production -Force

• 生成开发库模型：

Scaffold-DbContext "Server=tcp:dev-xxx.database.windows.net...;Initial Catalog=DevDb;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models/Development -Force

同时创建两个对应DbContext，并根据环境注册：

// ProductionDbContext.cs
public class ProductionDbContext : DbContext
{
    public ProductionDbContext(DbContextOptions<ProductionDbContext> options) : base(options) { }
    public DbSet<Models.Production.User> Users { get; set; }
}

// DevelopmentDbContext.cs
public class DevelopmentDbContext : DbContext
{
    public DevelopmentDbContext(DbContextOptions<DevelopmentDbContext> options) : base(options) { }
    public DbSet<Models.Development.User> Users { get; set; }
}

在Program.cs中根据环境注入：

var env = builder.Environment;
if (env.IsDevelopment())
{
    builder.Services.AddDbContext<DevelopmentDbContext>(opt => 
        opt.UseSqlServer(builder.Configuration.GetConnectionString("MainDb")));
}
else
{
    builder.Services.AddDbContext<ProductionDbContext>(opt => 
        opt.UseSqlServer(builder.Configuration.GetConnectionString("MainDb")));
}

方案B：Schema筛选+条件编译 #

若开发库仅新增少量表，可通过表筛选和条件编译区分模型：

• 生成基准库核心表：

Scaffold-DbContext "..." SqlServer -OutputDir Models -Tables User,Order -Force

• 生成开发库扩展表：

Scaffold-DbContext "..." SqlServer -OutputDir Models/DevExtensions -Tables DevFeatureLog -Force

在DbContext中用条件编译控制开发模型加载：

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
    
    // 基准实体
    public DbSet<User> Users { get; set; }
    public DbSet<Order> Orders { get; set; }

#if DEBUG
    // 仅开发环境加载的扩展实体
    public DbSet<Models.DevExtensions.DevFeatureLog> DevFeatureLogs { get; set; }
#endif
}

3. 外部架构变更的自动化优化 #

针对不受管控的数据库变更，可通过以下方式提效：

• 编写PowerShell/Bash脚本，封装scaffold命令，一键生成基准库模型
• 在Rider中配置外部工具：进入File > Settings > Tools > External Tools，添加工具，命令设为dotnet，参数设为ef dbcontext scaffold "基准库连接字符串" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models/Production -Force，绑定快捷键快速执行
• 每次scaffold后，用Rider的版本控制功能对比模型文件差异，快速识别外部变更内容，确认后再合并到开发分支

4. Azure Web App部署注意事项 #

• 在Azure Portal的Web App应用程序设置中，配置ConnectionStrings:MainDb为生产数据库连接字符串，禁止将生产连接字符串提交到代码仓库
• 使用Rider部署时，选择Release发布配置，确保加载生产环境配置

可选调整：混合模式（数据库优先+代码优先） #

若纯数据库优先模式管理成本过高，可切换混合模式：

• 外部管控的表：继续用数据库优先scaffold到只读目录，不手动修改
• 开发自定义的表：用代码优先模式编写实体和迁移
• 通过OnModelCreating方法在同一个DbContext中合并两种模型

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