Mac下用PostgreSQL执行dotnet ef migrations add InitialCreate时出错

问题详情 #

尝试为.NET Core 8应用使用EF Core 8.0.3添加迁移，执行dotnet ef migrations add InitialCreate命令时失败，错误提示：

Unable to create a 'DbContext' of type ''. The exception 'Unable to resolve service for type 'Microsoft.EntityFrameworkCore.DbContextOptions`1[ApplicationDbContext]' while attempting to activate 'ApplicationDbContext'.' was thrown while attempting to create an instance.

已执行操作 #

• 全局安装EF Core工具：dotnet tool install --global dotnet-ef
• 创建继承自DbContext的ApplicationDbContext类
• 定义Post、Article实体
• 在ApplicationDbContext的OnConfiguring方法中配置PostgreSQL（Npgsql）连接字符串

已排查项 #

• 确认项目csproj文件中已正确安装EF Core及Npgsql相关包
• 验证DbContext类和实体配置无语法错误
• 检查迁移命令拼写及选项无误

环境信息 #

• .NET Core 8
• EF Core 8.0.3
• PostgreSQL数据库
• 操作系统：Mac OS

相关代码 #

ApplicationDbContext.cs：

using Microsoft.EntityFrameworkCore;
using Nlighten.Models;

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

    public DbSet<Article> Articles { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseNpgsql("Server=127.0.0.1;Port=5432;Database=mydb;User Id=postgres;Password=mypwd;");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
    }
}

解决办法 #

核心原因 #

你的ApplicationDbContext同时存在带DbContextOptions<ApplicationDbContext>参数的构造函数，以及OnConfiguring方法中的硬编码配置。EF Core设计时工具优先尝试通过依赖注入获取DbContextOptions实例，但项目在设计阶段未配置DI容器，导致无法解析该服务，进而抛出错误。

具体修复方案 #

方案1：添加无参构造函数（快速临时修复）

给ApplicationDbContext添加无参构造函数，让EF Core工具直接调用该构造并执行OnConfiguring中的配置：

public class ApplicationDbContext : DbContext
{
    // 添加无参构造
    public ApplicationDbContext() : base()
    {
    }

    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options)
    {
    }

    // 其余代码不变...
}

方案2：移除带参数的构造函数（适合非DI场景）

如果项目不需要通过依赖注入使用ApplicationDbContext，可直接删除带DbContextOptions参数的构造函数，仅保留OnConfiguring方法：

public class ApplicationDbContext : DbContext
{
    public DbSet<Article> Articles { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseNpgsql("Server=127.0.0.1;Port=5432;Database=mydb;User Id=postgres;Password=mypwd;");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
    }
}

方案3：配置设计时DI（推荐，ASP.NET Core项目首选）

如果是ASP.NET Core应用，在Program.cs中配置DbContext的依赖注入，让EF Core工具自动识别配置：

var builder = WebApplication.CreateBuilder(args);

// 将DbContext注册到DI容器
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("DefaultConnection")));

// 其余项目配置...

var app = builder.Build();

// 中间件配置...

app.Run();

同时在appsettings.json中配置连接字符串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=127.0.0.1;Port=5432;Database=mydb;User Id=postgres;Password=mypwd;"
  }
}

完成后删除ApplicationDbContext中的OnConfiguring方法，保留带参数的构造函数即可。

方案4：执行命令时指定DbContext

执行迁移命令时，通过--context参数明确指定要使用的DbContext类型：

dotnet ef migrations add InitialCreate --context ApplicationDbContext

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