无法创建EF Core初始迁移：DbContext实例化失败求助

问题重现 #

执行命令 dotnet ef migrations add init 创建初始迁移时，触发错误：

无法创建类型为''的'DbContext'。尝试激活'ClubsLeague.Backend.Db.ClubContext'时，引发了异常“无法解析类型为'Microsoft.EntityFrameworkCore.DbContextOptions'的服务”。

当前使用的ClubContext代码：

namespace ClubsLeague.Backend.Db
{
    public class ClubContext : DbContext
    {
        public ClubContext(DbContextOptions options) : base(options)
        {
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {            
            optionsBuilder.UseSqlServer("Server=localhost;Database=ClubsLeague;User Id=sa;Password=Password!;");
            base.OnConfiguring(optionsBuilder);
        }

        public DbSet<User> Users { get; set; }
    }
}

解决方案 #

1. 修正DbContext构造函数与配置逻辑 #

构造函数需使用泛型DbContextOptions<ClubContext>，同时避免配置冲突：

namespace ClubsLeague.Backend.Db
{
    public class ClubContext : DbContext
    {
        public ClubContext(DbContextOptions<ClubContext> options) : base(options)
        {
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            // 仅在未通过依赖注入配置时使用硬编码连接串
            if (!optionsBuilder.IsConfigured)
            {
                optionsBuilder.UseSqlServer("Server=localhost;Database=ClubsLeague;User Id=sa;Password=Password!;");
            }
            base.OnConfiguring(optionsBuilder);
        }

        public DbSet<User> Users { get; set; }
    }
}

2. 在启动项目中注册DbContext服务 #

在.NET 6+的Program.cs中添加服务注册：

builder.Services.AddDbContext<ClubContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("ClubsLeague")));

同时在appsettings.json中配置连接字符串：

{
  "ConnectionStrings": {
    "ClubsLeague": "Server=localhost;Database=ClubsLeague;User Id=sa;Password=Password!;"
  }
}

3. 指定启动项目执行迁移命令 #

如果ClubContext位于类库项目，需明确指定启动项目和目标项目：

dotnet ef migrations add init --project ClubsLeague.Backend.Db --startup-project ClubsLeague.Backend.Api

替换命令中的项目名称为你实际的项目名称。

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