Entity Framework Core设计时无法创建AppDbContext对象的问题

执行dotnet ef migrations add InitialCreate时出现错误：

Unable to create an object of type 'AppDbContext'.

以下是针对性的解决建议：

1. 添加设计时DbContext工厂 #

创建一个实现IDesignTimeDbContextFactory<AppDbContext>的类，让EF Core工具在设计时能直接创建上下文实例：

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

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

        var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>();
        var connectionString = configuration.GetConnectionString("DefaultConnection");
        optionsBuilder.UseMySql(connectionString, ServerVersion.AutoDetect(connectionString));

        return new AppDbContext(optionsBuilder.Options);
    }
}

将该类放在与AppDbContext同一项目中，EF Core工具会自动识别并使用它创建上下文。

2. 指定启动项目和目标项目（多项目场景） #

若你的解决方案包含多个项目，执行迁移命令时需明确指定包含配置文件的启动项目和包含DbContext的目标项目：

dotnet ef migrations add InitialCreate --startup-project YourStartupProjectName --project YourDataProjectName

3. 确保配置文件可被读取 #

检查appsettings.json的文件属性：

• 右键文件 → 属性 → 复制到输出目录，设置为如果较新则复制或始终复制，确保设计时工具能访问到配置文件。

4. 临时添加OnConfiguring方法（排查用） #

可在AppDbContext中临时添加OnConfiguring方法，手动配置连接字符串，验证是否为配置读取问题：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        optionsBuilder.UseMySql("你的连接字符串", ServerVersion.AutoDetect("你的连接字符串"));
    }
}

问题解决后建议移除该方法，保持依赖注入的配置方式。

5. 检查工具与EF Core版本匹配 #

确保全局安装的EF Core工具版本和项目中引用的EF Core NuGet包版本一致，避免版本不兼容问题：

# 查看全局工具版本
dotnet ef --version
# 更新全局工具到最新版本
dotnet tool update --global dotnet-ef

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