.NET 6添加EF Core迁移报无法解析DbContextOptions错误

报错根因 #

.NET 6 使用顶级语句实现Minimal API后，EF Core设计时工具默认查找Program类中静态CreateHostBuilder(string[])方法的逻辑会失效，同时你的ApplicationDbContext存放在独立的DataAccess类库中，未给设计时工具提供明确的上下文创建路径，最终触发无法解析DbContextOptions、找不到应用服务提供程序的错误。你添加的无参ApplicationDbContext构造函数未搭配OnConfiguring配置连接逻辑，设计时迁移阶段不会生效。

修复步骤 #

方案1：配置主项目为设计时入口（生产项目推荐） #

1. 为主Web项目（即包含Program.cs的issuemaster项目）安装以下NuGet包，确保所有EF Core相关包版本完全一致：
   • Microsoft.EntityFrameworkCore.Design
   • 对应数据库的EF Core提供程序包（如SQL Server对应Microsoft.EntityFrameworkCore.SqlServer）
   • Microsoft.AspNetCore.Identity.EntityFrameworkCore
2. 修改ApplicationDbContext的构造函数，使用泛型DbContextOptions避免注入类型不匹配，删除无用的无参构造函数：

   public class ApplicationDbContext : IdentityDbContext<IdentityUser>
   {
       public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
       : base(options)
       {
       }
   
       public DbSet<Attachment> Attachments { get; set; }
       public DbSet<Column> Columns { get; set; }
       public DbSet<DevopsBoard> DevopsBoards { get; set; }
       public DbSet<DevopsBug> DevopsBugs { get; set; }
       public DbSet<Priority> Priorities { get; set; }
       public DbSet<Project> Projects { get; set; }
       public DbSet<Severity> Severities { get; set; }
   }
   

3. 确认主项目Program.cs中已正确注册DbContext，同时在文件末尾添加公开的partial Program类，解决顶级语句下EF工具无法访问入口类的问题：

   var builder = WebApplication.CreateBuilder(args);
   
   // 注册DbContext，从配置文件读取连接字符串
   builder.Services.AddDbContext<ApplicationDbContext>(options =>
       options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
   
   // 其余服务注册、中间件配置保持原有逻辑不变
   var app = builder.Build();
   // ... 你的原有中间件配置
   app.Run();
   
   // 必须添加，给EF Core设计时工具暴露可访问的入口
   public partial class Program { }
   

4. 执行迁移时必须指定主Web项目为启动项目，不要将DataAccess类库设为启动项，正确命令如下：

   Add-Migration FirstInit -Project DataAccess -StartupProject issuemaster -Verbose
   

   参数说明：
   • -Project DataAccess：指定迁移文件生成在存放DbContext的DataAccess项目中
   • -StartupProject issuemaster：指定EF工具从主项目读取服务配置、连接字符串等运行时信息

方案2：添加设计时工厂（独立类库通用方案） #

如果需要DataAccess类库完全独立、不依赖主项目入口，可以在DataAccess项目中实现IDesignTimeDbContextFactory，EF Core迁移时会优先识别该实现，无需依赖启动项目的服务配置：

1. 给DataAccess项目安装Microsoft.EntityFrameworkCore.Design包
2. 在DataAccess项目根目录添加工厂类：

   using Microsoft.EntityFrameworkCore;
   using Microsoft.EntityFrameworkCore.Design;
   using Microsoft.Extensions.Configuration;
   using System.IO;
   
   namespace DataAccess.Data
   {
       public class ApplicationDbContextFactory : IDesignTimeDbContextFactory<ApplicationDbContext>
       {
           public ApplicationDbContext CreateDbContext(string[] args)
           {
               // 读取主项目目录下的配置文件，根据你的实际项目路径调整
               var config = new ConfigurationBuilder()
                   .SetBasePath(Path.Combine(Directory.GetCurrentDirectory(), "..", "issuemaster"))
                   .AddJsonFile("appsettings.json")
                   .Build();
   
               var optionsBuilder = new DbContextOptionsBuilder<ApplicationDbContext>();
               // 替换为你实际使用的数据库提供程序配置
               optionsBuilder.UseSqlServer(config.GetConnectionString("DefaultConnection"));
   
               return new ApplicationDbContext(optionsBuilder.Options);
           }
       }
   }
   

3. 添加工厂类后可直接执行迁移命令，无需额外指定启动项目：

   Add-Migration FirstInit -Project DataAccess -Verbose
   

避坑说明 #

• 类库项目不能作为迁移启动项目，类库无独立运行入口，EF工具无法加载配置和服务注册必然报错
• 所有项目引用的EF Core相关包版本必须完全一致，版本不兼容会导致设计时工具加载失败
• 若使用无参构造函数，必须重写OnConfiguring方法指定连接字符串，否则运行时和设计时都无法正常创建DbContext实例

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