EF6迁移至EF Core 3.0：DbContext基于DbConnection初始化的替代方案及变更原因

一、EF Core中复用现有DbConnection的替代方案 #

EF Core确实不再直接支持接收DbConnection的构造函数，但我们可以通过DbContextOptions来实现相同的效果——传入现有连接并关联事务。具体步骤如下：

1. 更新MyDataContext的构造函数
   首先给你的上下文添加EF Core标准的构造函数，接收DbContextOptions<MyDataContext>：

   public class MyDataContext : DbContext
   {
       public MyDataContext(DbContextOptions<MyDataContext> options) : base(options)
       {
       }
       // 其他DbSet和配置代码...
   }
   

2. 手动构建DbContextOptions并传入现有连接
   在你的UnitOfWorkSetupBehavior中，不再直接用连接实例化上下文，而是通过DbContextOptionsBuilder来配置，指定现有连接并设置不接管连接所有权（对应EF6构造里的false参数）：

   var pipeline = endpointConfiguration.Pipeline;
   pipeline.Register(new UnitOfWorkSetupBehavior(storageSession => 
   {
       var dbConnection = storageSession.SqlPersistenceSession().Connection;
       var transaction = storageSession.SqlPersistenceSession().Transaction;
   
       // 构建DbContextOptions，传入现有连接
       var options = new DbContextOptionsBuilder<MyDataContext>()
           .UseSqlServer(dbConnection, options => options.EnableRetryOnFailure())
           .Options;
   
       // 实例化上下文
       var context = new MyDataContext(options);
       // 关联现有事务
       context.Database.UseTransaction(transaction);
   
       storageSession.SqlPersistenceSession().OnSaveChanges(x => context.SaveChangesAsync());
       return context;
   }), "Setting up unit of work");
   

   这里的关键是UseSqlServer方法直接传入已有的DbConnection实例，EF Core会复用这个连接而不是新建。另外，options.EnableRetryOnFailure()是可选配置，根据你的业务需求决定是否添加。

3. 额外注意事项

   • 确保传入的DbConnection处于打开状态（EF Core对连接状态的要求比EF6更严格，建议提前确认）。
   • 事务关联操作必须在上下文执行任何查询或变更之前完成，否则会抛出异常。

二、EF Core不再支持原有构造函数的原因 #

EF Core的设计理念和EF6有本质差异，放弃直接接收DbConnection的构造主要基于以下几点考虑：

• 统一配置入口：EF Core将所有上下文配置（数据库提供商、连接信息、日志级别、缓存策略等）都收拢到DbContextOptions中，不管是依赖注入创建上下文还是手动实例化，都使用统一的配置方式，避免了EF6中多种构造函数带来的配置分散问题。
• 适配依赖注入模式：现代.NET应用普遍采用依赖注入（DI）架构，EF Core的设计完全贴合这一趋势——通过DI容器注册DbContextOptions后，上下文可以自动注入，无需手动处理连接或配置，大幅提升了代码的可维护性和可测试性。
• 明确资源所有权：通过DbContextOptions配置连接时，可以更清晰地控制连接的生命周期（比如是否由EF Core接管关闭），减少了资源泄漏的风险。EF6的构造函数参数bool contextOwnsConnection虽然也能控制，但放在构造函数里不如在Options中配置直观。
• 更强的扩展性：DbContextOptions支持扩展各种数据库提供商的特定配置，而EF6的构造函数只能处理基础连接，扩展性有限。

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