.NET5 Web API使用EF Core Power Tools时正确注入DbContext连接字符串的最佳实践

错误根因 #

• 控制器中直接使用new ApplicationDbContext()调用了无参构造函数，该构造未绑定你在Startup中配置的SqlServer驱动与连接字符串，导致DbContext没有识别到可用的数据库提供者
• 直接修改EF Core Power Tools自动生成的DbContext文件，每次刷新模型时工具都会覆盖原有内容，自定义配置无法保留

推荐实现方案 #

方案1：依赖注入实现（官方推荐，无需修改DbContext代码） #

ASP.NET Core原生提供了依赖注入管理DbContext生命周期，你已经在Startup中完成了DbContext的注册，只需调整控制器的使用方式即可：

1. 改造控制器，通过构造函数注入ApplicationDbContext实例

namespace API.Controllers
{
    [ApiController]
    [Route("example")]
    public class ExampleController : ControllerBase
    {
        private readonly ApplicationDbContext _db;
        // 构造函数注入已配置好的DbContext实例
        public ExampleController(ApplicationDbContext db)
        {
            _db = db;
        }

        [HttpGet("test")]
        [ProducesResponseType(StatusCodes.Status200OK)]
        [ProducesResponseType(StatusCodes.Status404NotFound)]
        public ActionResult<ApiResponse> GetExample()
        {
            // 直接使用注入的实例，无需手动using释放，DI会在请求结束后自动回收
            var data = _db.你的表名.ToList();
            // 后续业务逻辑
        }
    }
}

该方案完全符合微软官方规范，无需修改任何工具生成的代码，DbContext的生命周期由框架统一管理，避免手动释放导致的资源问题。

方案2：Partial类扩展（兼容现有new ApplicationDbContext()写法） #

如果项目中已有大量手动new DbContext的代码不想改动，可以利用自动生成的ApplicationDbContext是partial类的特性，新增独立的扩展文件，不会被工具覆盖：

1. 新建文件ApplicationDbContext.Partial.cs，放在你的项目Data目录下，内容如下：

using Microsoft.EntityFrameworkCore;
namespace API.Data
{
    public partial class ApplicationDbContext : DbContext
    {
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            // 若已通过DI注入配置过参数则跳过，避免重复配置
            if (!optionsBuilder.IsConfigured)
            {
                // 读取全局配置中的连接字符串
                optionsBuilder.UseSqlServer(Globals.Configuration.GetConnectionString("DefaultConnection"));
            }
        }
    }
}

该文件是独立存在的，EF Core Power Tools刷新模型时只会修改它自己生成的ApplicationDbContext.cs文件，不会影响你自定义的partial文件，配置可以永久保留。

额外优化建议 #

你当前Startup构造函数中不需要重新构建Configuration实例，.NET 5默认的Web主机初始化逻辑已经自动加载了appsettings.json、环境变量等配置源，直接使用注入的IConfiguration即可：

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

避免重复加载配置导致的性能损耗和潜在的配置不一致问题。

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