如何封装EF多数据库迁移通用逻辑为类库，仅替换DataSet且保留迁移功能

现有实现的认知偏差 #

• 错误绑定“DbSet必须通过固定接口/属性约束”：EF Core的核心是实体类型的注册，DbSet只是实体的便捷访问入口，不需要强制将其作为固定属性定义在接口中，完全可以通过反射动态发现。
• 错误认为“实例替代继承会丢失DbContext迁移特性”：EF迁移要求的是存在继承自DbContext的具体派生类，并非必须让业务逻辑直接继承DbContext，通过泛型基类的方式既可以封装通用逻辑，又能保留DbContext的继承链。

可落地的封装方案 #

1. 类库中封装泛型通用DbContext基类 #

将多数据库配置、实体注册等通用逻辑封装到泛型基类中，泛型参数指定用户项目的DataSet类（仅负责定义DbSet）：

// 类库中的通用基类，封装多库配置与实体发现逻辑
public abstract class GenericDbContext<TDataSet> : DbContext 
    where TDataSet : class, new()
{
    protected readonly TDataSet DataSet = new TDataSet();

    // 多数据库通用配置逻辑（可通过构造函数注入配置灵活切换）
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 示例：从配置读取连接字符串与数据库类型，替换为实际逻辑
        var config = new ConfigurationBuilder()
            .AddJsonFile("appsettings.json")
            .Build();
        var connStr = config.GetConnectionString("DefaultConnection");
        var dbType = config["Database:Type"];

        switch (dbType)
        {
            case "SqlServer":
                optionsBuilder.UseSqlServer(connStr);
                break;
            case "MySql":
                optionsBuilder.UseMySql(connStr, ServerVersion.AutoDetect(connStr));
                break;
        }
        base.OnConfiguring(optionsBuilder);
    }

    // 动态注册DataSet中的所有实体
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 反射扫描DataSet中所有DbSet属性，自动注册对应实体
        var dbSetProps = typeof(TDataSet).GetProperties()
            .Where(p => p.PropertyType.IsGenericType && 
                        p.PropertyType.GetGenericTypeDefinition() == typeof(DbSet<>));
        
        foreach (var prop in dbSetProps)
        {
            var entityType = prop.PropertyType.GetGenericArguments()[0];
            modelBuilder.Entity(entityType);
        }

        // 可添加通用模型配置（如软删除、审计字段）
        base.OnModelCreating(modelBuilder);
    }
}

2. 用户项目中定义轻量DataSet类 #

DataSet仅负责声明业务实体的DbSet，无需继承任何类：

// 用户项目专属的DataSet，新增/修改实体仅需调整此处
public class AppDataSet
{
    public DbSet<User> Users { get; set; }
    public DbSet<Order> Orders { get; set; }
}

3. 用户项目中创建具体DbContext派生类 #

仅需继承类库的泛型基类，指定DataSet类型，满足EF迁移的要求：

// 用户项目的具体DbContext，仅用于迁移与DI注入
public class AppDbContext : GenericDbContext<AppDataSet>
{
    // 支持DI注入的构造函数（可选，根据项目需求添加）
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
    {
    }
}

4. 多数据库实例创建与迁移命令 #

• 多数据库实例：类库可封装工厂类，根据配置创建对应数据库的DbContext实例，示例：

// 类库中的DbContext工厂
public static class DbContextFactory
{
    public static TDbContext Create<TDbContext, TDataSet>(string connStr, string dbType)
        where TDbContext : GenericDbContext<TDataSet>
        where TDataSet : class, new()
    {
        var optionsBuilder = new DbContextOptionsBuilder<TDbContext>();
        switch (dbType.ToLower())
        {
            case "sqlserver":
                optionsBuilder.UseSqlServer(connStr);
                break;
            case "mysql":
                optionsBuilder.UseMySql(connStr, ServerVersion.AutoDetect(connStr));
                break;
        }
        return (TDbContext)Activator.CreateInstance(typeof(TDbContext), optionsBuilder.Options);
    }
}

• 迁移命令：直接针对用户项目的AppDbContext执行迁移，完全兼容EF命令：

# 创建初始迁移
Add-Migration InitialCreate -Context AppDbContext
# 更新数据库
Update-Database -Context AppDbContext

方案优势 #

• 类库完全封装通用逻辑，用户项目仅需维护DataSet与轻量DbContext派生类，实现“仅替换DataSet”的需求
• 保留完整的DbContext继承链，完全支持EF Core的迁移功能
• DataSet可自由扩展DbSet，无需修改类库代码，适配新项目快速迭代

内容的提问来源于stack exchange，提问作者Dang-gun Roleeyas