.NET 6类库项目EF Core Code First建库遇错求助

问题场景 #

我有一个.NET 6独立类库项目（无Web API/MVC项目），已添加Producer、Product实体类及AppDbContext类，运行add-migration命令时出现错误："Unable to create an object of type 'AppDbContext'"，改用控制台项目作为启动项目后错误依旧。

实体类及上下文代码 #

Producer类

public class Producer
{
    [Key]
    public int ProducerID { get; set; }
    [Required]
    [StringLength(254)]
    public string Name { get; set; }
    public ICollection<Product> Products { get; set; }
}

Product类

public class Product
{
    [Key]
    public int ProductID { get; set; }
    public int ProducerID { get; set; }
    [Required]
    [StringLength(254)]
    public string Name { get; set; }
    public Producer Producer { get; set;}
}

AppDbContext类

public class AppDbContext : DbContext
{
    private readonly string _connectionString;
    private readonly IConfiguration _iConfig;
    public AppDbContext(DbContextOptions<AppDbContext> options, IConfiguration iConfig) : base(options) {
        _connectionString = GetConnectionString(iConfig);
        _iConfig = iConfig;
    }

    public static string GetConnectionString(IConfiguration iConfig)
    {
        var dataSource = iConfig["db:serverName"];
        var port = iConfig["db:port"];
        if (!string.IsNullOrWhiteSpace(port))
            dataSource += "," + port;

        SqlConnectionStringBuilder builder = new()
        {
            ["Data Source"] = dataSource,
            ["Initial Catalog"] = iConfig["db:initialCatalog"],
            ["User ID"] = iConfig["db:userId"],
            ["Password"] = iConfig["db:password"]
        };

        return builder.ConnectionString;
    }
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
                                          => optionsBuilder.UseSqlServer(_connectionString);

    public DbSet<Producer> Producers { get; set; }
    public DbSet<Product> Products { get; set; }
}

错误原因 #

EF Core迁移工具执行add-migration时，需要创建AppDbContext实例，但你的上下文构造函数依赖了DbContextOptions<AppDbContext>和IConfiguration，迁移工具无法自动解析这些依赖项——尤其是在类库+控制台启动项目的场景下，没有配置完整的依赖注入服务链，导致工具无法实例化上下文。

解决方法 #

推荐使用EF Core官方提供的IDesignTimeDbContextFactory接口，手动实现设计时上下文的创建逻辑，让迁移工具能正确获取上下文实例。

步骤1：添加设计时上下文工厂 #

在类库项目中创建一个新类AppDbContextFactory，实现IDesignTimeDbContextFactory<AppDbContext>接口：

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

public class AppDbContextFactory : IDesignTimeDbContextFactory<AppDbContext>
{
    public AppDbContext CreateDbContext(string[] args)
    {
        // 加载控制台项目根目录的appsettings.json配置文件
        var configBuilder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json");

        var configuration = configBuilder.Build();
        var connectionString = AppDbContext.GetConnectionString(configuration);

        // 构建DbContextOptions
        var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>();
        optionsBuilder.UseSqlServer(connectionString);

        // 创建并返回上下文实例
        return new AppDbContext(optionsBuilder.Options, configuration);
    }
}

步骤2：配置控制台项目的appsettings.json #

确保控制台启动项目的根目录下有appsettings.json，并且包含正确的数据库配置节点：

{
  "db": {
    "serverName": "你的数据库服务器地址",
    "port": "1433",
    "initialCatalog": "你的数据库名称",
    "userId": "数据库账号",
    "password": "数据库密码"
  }
}

同时，右键该文件→属性→设置复制到输出目录为如果较新则复制或始终复制。

步骤3：调整AppDbContext的OnConfiguring方法（可选但推荐） #

修改OnConfiguring方法，仅当未配置DbContextOptions时才设置连接字符串，避免运行时和设计时的配置冲突：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        optionsBuilder.UseSqlServer(_connectionString);
    }
}

步骤4：执行迁移命令 #

在Package Manager Console中：

1. 确保默认项目选择你的类库项目
2. 确保启动项目选择你的控制台项目
3. 运行add-migration InitialCreate命令即可正常生成迁移

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