.NET 7中Persistence项目配置DbContext生成迁移报错

问题根源 #

执行dotnet ef migrations add InitialCreate报错的核心原因：

• Persistence是类库项目，无独立的配置与服务提供环境，EF Core设计时无法解析IConfiguration依赖，也无法读取启动项目中的DbContext注册逻辑。
• 错误提示无法解析DbContextOptions，是因为设计时激活DbContext时，缺少正确的依赖注入支持。

可行解决方案 #

方案1：执行命令时指定启动项目 #

由于DbContext的配置和注册在独立启动项目中，执行迁移命令时需明确指定启动项目路径，让EF Core复用启动项目的配置环境：
在Persistence目录下执行：

dotnet ef migrations add InitialCreate --startup-project ../[你的启动项目文件夹名]

替换[你的启动项目文件夹名]为实际启动项目的目录名称（如../Api）。

方案2：在Persistence中添加设计时DbContext工厂 #

在Persistence项目中创建实现IDesignTimeDbContextFactory<PizzaDeliveryDbContext>的类，让EF Core设计时能直接生成DbContext实例：

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

namespace Persistence.Context
{
    public class PizzaDeliveryDbContextFactory : IDesignTimeDbContextFactory<PizzaDeliveryDbContext>
    {
        public PizzaDeliveryDbContext CreateDbContext(string[] args)
        {
            // 加载启动项目的配置文件
            IConfiguration config = new ConfigurationBuilder()
                .SetBasePath(Path.Combine(Directory.GetCurrentDirectory(), "../[你的启动项目文件夹名]"))
                .AddJsonFile("appsettings.json")
                .Build();

            return new PizzaDeliveryDbContext(config);
        }
    }
}

替换[你的启动项目文件夹名]为实际启动项目目录，添加后直接执行原迁移命令即可。

方案3：修改DbContext构造函数 #

为PizzaDeliveryDbContext添加支持设计时的构造函数，保留原有依赖注入逻辑：

public class PizzaDeliveryDbContext : DbContext
{
    private readonly IConfiguration _config;

    // 用于运行时依赖注入的构造函数
    public PizzaDeliveryDbContext(IConfiguration config)
    {
        _config = config;
    }

    // 用于EF Core设计时的构造函数
    public PizzaDeliveryDbContext(DbContextOptions<PizzaDeliveryDbContext> options) : base(options)
    {
    }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 仅当未通过Options配置时，使用IConfiguration读取连接字符串
        if (!optionsBuilder.IsConfigured)
        {
            optionsBuilder.UseNpgsql(_config.GetConnectionString("pizza"));
        }
    }

    // DbSet定义...
}

修改后仍需使用方案1的命令（指定启动项目）执行迁移。

验证标准 #

执行命令后，Persistence项目中生成Migrations文件夹及对应初始迁移文件，即为操作成功。

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