EF Core迁移操作指引：多项目中Infrastructure层DbContext迁移报错排查

现有代码的明确问题点 #

• 配置逻辑冲突：你同时实现了接收DbContextOptions的依赖注入构造函数、以及在OnConfiguring方法中硬编码Npgsql配置。EF Core工具执行迁移时会优先走OnConfiguring的硬编码逻辑，绕过启动项目中的服务注册流程，极易出现程序集加载失败、配置不匹配类报错。
• 类库无执行入口：DbContext定义在Infrastructure类库项目中，但EF Core迁移工具必须绑定一个可执行的启动项目才能完成依赖加载、服务解析。如果直接在Infrastructure目录下执行迁移命令，会直接报找不到DbContext、无法创建设计时实例的错误。
• 连接串键名不兼容：你写的连接串使用了uid、pwd作为认证参数键，这是SQL Server的常用写法，Npgsql官方驱动实际识别的认证键为Username、Password，即使配置逻辑生效也会报数据库认证失败。

分步修复方案 #

1. 调整DbContext配置，移除冲突代码 #

优先保留依赖注入的配置方式，删掉OnConfiguring中的硬编码配置，调整后的主上下文代码如下：

using Infrastructure.Models;
using Microsoft.EntityFrameworkCore;

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

        public DbSet<EventModel> Event { get; set; }
    }    
}

如果需要让Infrastructure类库脱离启动项目独立完成EF设计时操作（比如不想每次迁移都手动指定启动项目），单独实现IDesignTimeDbContextFactory即可，不要把硬编码逻辑写进主上下文的生命周期里，示例：

using Microsoft.EntityFrameworkCore;

namespace Infrastructure
{
    public class ApplicationDbContextDesignTimeFactory : IDesignTimeDbContextFactory<ApplicationDbContext>
    {
        public ApplicationDbContext CreateDbContext(string[] args)
        {
            var optionsBuilder = new DbContextOptionsBuilder<ApplicationDbContext>();
            // 使用Npgsql兼容的连接串键名
            optionsBuilder.UseNpgsql("Server=localhost;Database=myDb;Username=postgres;Password=root;Pooling=true;");
            return new ApplicationDbContext(optionsBuilder.Options);
        }
    }
}

2. 补齐必要的包引用与服务注册 #

• 给Infrastructure项目添加 Microsoft.EntityFrameworkCore.Design 包引用，否则EF工具会报缺失设计时组件的错误
• 在解决方案中的可执行启动项目（WebApi、Console等）的服务注册流程中，添加DbContext的注册逻辑，以.NET 6+顶级语句的Program.cs为例：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("DefaultConnection")));

• 在启动项目的appsettings.json中配置正确的Npgsql连接串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=myDb;Username=postgres;Password=root;Pooling=true;"
  }
}

3. 执行正确的迁移命令 #

必须明确指定上下文所在项目、启动项目的对应关系，不要直接在Infrastructure项目目录下执行命令：

• .NET CLI 执行方式（在解决方案根目录运行）：

# 新增迁移
dotnet ef migrations add InitialCreate --project Infrastructure --startup-project 你的启动项目名称
# 更新数据库
dotnet ef database update --project Infrastructure --startup-project 你的启动项目名称

• Visual Studio 程序包管理器控制台执行方式：

Add-Migration InitialCreate -Project Infrastructure -StartupProject 你的启动项目名称
Update-Database -Project Infrastructure -StartupProject 你的启动项目名称

内容的提问来源于stack exchange，提问作者Александр Радченко