C#中DbContext实现的抽象化方案问询

这是个很常见的多版本DbContext适配场景，我给你一步步拆解实现方案，保证清晰好用：

首先搞个枚举明确区分不同架构版本，避免直接传字符串/数字容易出错：

public enum DatabaseSchemaVersion
{
    V1,
    V2,
    V3
}

VS自动生成的DbContext默认都是部分类（partial），咱们可以定义一个包含所有公共属性和方法的接口，再让每个自动生成的DbContext通过部分类实现这个接口——这样既不会被自动生成的代码覆盖，又能统一对外的契约。

先写公共接口：

public interface ICommonDbContext : IDisposable
{
    // 列出三个DbContext共有的DbSet属性，比如：
    DbSet<User> Users { get; }
    DbSet<Order> Orders { get; }

    // 再把DbContext的核心方法也加进来：
    int SaveChanges();
    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
    void Detach(object entity);
    // 其他你需要用到的DbContext方法都可以加在这里
}

然后给每个自动生成的DbContext加部分类实现接口：

// 对应自动生成的DbContextV1
public partial class DbContextV1 : ICommonDbContext
{
    // 不用重复写属性/方法，自动生成的代码已经包含，接口会自动匹配
}

// 对应自动生成的DbContextV2
public partial class DbContextV2 : ICommonDbContext
{
}

// 对应自动生成的DbContextV3
public partial class DbContextV3 : ICommonDbContext
{
}

这个类就是对外暴露的统一入口，它会根据传入的版本参数创建对应的DbContext实例，并且把所有属性/方法委托给内部实例：

public class UnifiedDbContext : ICommonDbContext
{
    private readonly ICommonDbContext _innerContext;

    // 构造函数1：简单场景用，直接传版本和连接字符串
    public UnifiedDbContext(DatabaseSchemaVersion version, string connectionString)
    {
        _innerContext = version switch
        {
            DatabaseSchemaVersion.V1 => new DbContextV1(new DbContextOptionsBuilder<DbContextV1>()
                .UseSqlServer(connectionString)
                .Options),
            DatabaseSchemaVersion.V2 => new DbContextV2(new DbContextOptionsBuilder<DbContextV2>()
                .UseSqlServer(connectionString)
                .Options),
            DatabaseSchemaVersion.V3 => new DbContextV3(new DbContextOptionsBuilder<DbContextV3>()
                .UseSqlServer(connectionString)
                .Options),
            _ => throw new ArgumentOutOfRangeException(nameof(version), "不支持的数据库架构版本")
        };
    }

    // 构造函数2：依赖注入友好版（推荐在ASP.NET Core等DI场景使用）
    public UnifiedDbContext(DatabaseSchemaVersion version, IServiceProvider serviceProvider)
    {
        _innerContext = version switch
        {
            DatabaseSchemaVersion.V1 => serviceProvider.GetRequiredService<DbContextV1>(),
            DatabaseSchemaVersion.V2 => serviceProvider.GetRequiredService<DbContextV2>(),
            DatabaseSchemaVersion.V3 => serviceProvider.GetRequiredService<DbContextV3>(),
            _ => throw new ArgumentOutOfRangeException(nameof(version), "不支持的数据库架构版本")
        };
    }

    // 委托所有公共属性
    public DbSet<User> Users => _innerContext.Users;
    public DbSet<Order> Orders => _innerContext.Orders;

    // 委托所有公共方法
    public int SaveChanges() => _innerContext.SaveChanges();
    public Task<int> SaveChangesAsync(CancellationToken cancellationToken = default) 
        => _innerContext.SaveChangesAsync(cancellationToken);

    public void Detach(object entity)
    {
        if (_innerContext is DbContext dbCtx)
        {
            dbCtx.Entry(entity).State = EntityState.Detached;
        }
    }

    // 实现IDisposable，释放内部DbContext
    public void Dispose()
    {
        _innerContext.Dispose();
        GC.SuppressFinalize(this);
    }
}

• 实体类差异处理：如果不同版本的实体类有差异（比如V1的User有旧字段，V2没有），可以考虑：
  • 定义基础实体类/接口，让不同版本实体继承/实现，接口中用DbSet<IBaseUser>（注意EF Core对泛型DbSet支持有限，可能需要额外处理）
  • 或者在统一类中做实体转换，对外返回统一DTO
• DI容器注册（ASP.NET Core）：

  services.AddDbContext<DbContextV1>(options => 
      options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
  services.AddDbContext<DbContextV2>(options => 
      options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
  services.AddDbContext<DbContextV3>(options => 
      options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
  
  // 注册统一类，版本从配置读取
  services.AddScoped<UnifiedDbContext>(sp =>
  {
      var version = Enum.Parse<DatabaseSchemaVersion>(Configuration["Database:SchemaVersion"]);
      return new UnifiedDbContext(version, sp);
  });
  

• 绝对不要直接修改自动生成的DbContext代码：一定要用部分类扩展，不然下次重新生成时你的代码会被覆盖！

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