升级至ASP.NET Core 5.0.1后EF Core Code First Update-Database失败求助

我帮你梳理几个常见的排查方向和解决办法，都是升级EF Core后容易遇到的问题：

1. 确保EF Core工具版本与项目版本匹配 #

升级到ASP.NET Core 5.0.1后，全局安装的EF工具版本也需要同步到5.x系列，否则会出现版本不兼容的问题：

• 在PMC里执行以下命令检查当前工具版本：

  dotnet tool list --global
  

• 如果dotnet-ef的版本不是5.0.x，执行更新命令：

  dotnet tool update --global dotnet-ef --version 5.0.1
  

2. 执行命令时明确指定DbContext和项目 #

有时候EF工具会混淆项目或上下文，手动指定参数可以解决这个问题：

Update-Database -Context SaberDbContext -Project SaberTooth.Model

同样，Remove-Migration也可以加上这些参数：

Remove-Migration -Context SaberDbContext -Project SaberTooth.Model

3. 检查SaberDbContext的构造函数 #

EF Core设计时工具需要能实例化你的DbContext，确保它有可访问的构造函数：

• 推荐的方式是包含一个接受DbContextOptions<SaberDbContext>的public构造函数：

  public class SaberDbContext : DbContext
  {
      public SaberDbContext(DbContextOptions<SaberDbContext> options) : base(options)
      {
      }
      // 其他DbSet定义...
  }
  

• 如果你的配置是从appsettings.json读取的，也可以添加一个无参构造函数（不过更推荐用上面的方式）。

4. 确认启动项目设置正确 #

右键你的解决方案，选择设置启动项目，确保选中的是SaberTooth.Model项目。如果启动项目是其他项目，EF工具可能找不到Program类里的CreateHostBuilder方法。

5. 添加IDesignTimeDbContextFactory（终极方案） #

如果上面的方法都无效，可以手动实现设计时工厂，让EF工具明确知道如何创建DbContext实例。在SaberTooth.Model项目中添加以下类：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
using Microsoft.Extensions.Configuration;
using System.IO;

namespace SaberTooth.Model
{
    public class SaberDbContextFactory : IDesignTimeDbContextFactory<SaberDbContext>
    {
        public SaberDbContext CreateDbContext(string[] args)
        {
            // 读取项目的配置文件
            var configBuilder = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json");

            var configuration = configBuilder.Build();
            // 替换成你的数据库连接字符串名称和数据库提供者（比如UseSqlite、UseMySql等）
            var connectionString = configuration.GetConnectionString("DefaultConnection");

            var optionsBuilder = new DbContextOptionsBuilder<SaberDbContext>();
            optionsBuilder.UseSqlServer(connectionString);

            return new SaberDbContext(optionsBuilder.Options);
        }
    }
}

添加这个类后，EF工具会优先使用它来创建DbContext，不再依赖Program类的CreateHostBuilder方法。

你可以从第一个方法开始尝试，逐步排查，应该能解决问题。

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