添加首次EF Core迁移时DbContext创建失败，求解决方案

问题详情 #

添加首次迁移时遇到以下错误：

无法创建类型为''的'DbContext'。异常信息：'未为此DbContext配置数据库提供程序。可通过重写'DbContext.OnConfiguring'方法或在应用程序服务提供程序上使用'AddDbContext'进行配置。'

上下文类代码：

public partial class MyContext : DbContext
{
    public MyContext(DbContextOptions<MyContext> options)
        : base(options)
    { }

    public virtual DbSet<User> Users { get; set; }
    
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        OnModelCreatingPartial(modelBuilder);
    }

    partial void OnModelCreatingPartial(ModelBuilder modelBuilder);
}

Program.cs配置代码：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
builder.Services.AddRazorPages();
builder.Services.AddDbContext<MyContext>(options =>
    options
        .UseMySql( builder.Configuration.GetConnectionString("MyContext"), new MariaDbServerVersion("10.5.18-MariaDB") )
);
builder.Services.AddTransient<IUserManager, UserManager>();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseMigrationsEndPoint();
    app.UseWebAssemblyDebugging();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
app.UseHttpsRedirection();
app.UseBlazorFrameworkFiles();
app.UseStaticFiles();
app.UseRouting();
app.MapRazorPages();
app.MapControllers();
app.MapFallbackToFile("index.html");
app.Run();

解决方案 #

1. 确认连接字符串配置正确 #

检查appsettings.json中是否存在正确的连接字符串，格式示例：

"ConnectionStrings": {
  "MyContext": "server=localhost;database=你的数据库名称;user=数据库用户名;password=数据库密码;"
}

注意：确保字符串中的服务器地址、数据库名、账号密码与实际环境匹配，没有拼写错误。

2. 确保EF迁移工具能读取到配置 #

• Package Manager Console：执行迁移前，确认解决方案的启动项目是配置了DbContext的Web项目（即包含Program.cs的项目）。
• .NET CLI：如果在类库项目目录下执行迁移，需要指定启动项目路径：

dotnet ef migrations add InitialCreate --startup-project ../你的Web项目文件夹名称

3. 检查必要的NuGet包是否安装完整 #

确保项目已安装以下包：

• Microsoft.EntityFrameworkCore.Tools：迁移工具核心依赖
• Pomelo.EntityFrameworkCore.MySql：MySQL/MariaDB的EF Core提供程序
• Microsoft.EntityFrameworkCore.Design：设计时工具支持

通过.NET CLI安装：

dotnet add package Microsoft.EntityFrameworkCore.Tools
dotnet add package Pomelo.EntityFrameworkCore.MySql
dotnet add package Microsoft.EntityFrameworkCore.Design

或Package Manager Console：

Install-Package Microsoft.EntityFrameworkCore.Tools
Install-Package Pomelo.EntityFrameworkCore.MySql
Install-Package Microsoft.EntityFrameworkCore.Design

4. 验证DbContext注册逻辑 #

你的Program.cs中已经正确使用AddDbContext注册了MyContext并指定了MySQL提供程序，需确认：

• MariaDbServerVersion的版本号与你的MariaDB服务器版本完全匹配（可通过SELECT VERSION();在数据库中查询）
• 没有拼写错误，比如泛型参数MyContext是否正确

5. 可选：添加设计时工厂（以上步骤无效时） #

如果EF工具仍无法自动找到配置，可添加一个设计时工厂类，手动创建DbContext实例：

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

public class MyContextDesignTimeFactory : IDesignTimeDbContextFactory<MyContext>
{
    public MyContext CreateDbContext(string[] args)
    {
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();

        var optionsBuilder = new DbContextOptionsBuilder<MyContext>();
        optionsBuilder.UseMySql(
            configuration.GetConnectionString("MyContext"), 
            new MariaDbServerVersion("10.5.18-MariaDB")
        );

        return new MyContext(optionsBuilder.Options);
    }
}

将该类放在与MyContext同一个项目中，EF迁移工具执行时会自动使用这个工厂创建DbContext实例。

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