.NET 6扩展IdentityDbContext：迁移时避免多上下文报错

核心问题分析 #

你遇到的"找到多个DbContext"错误，是因为EF Core会扫描所有继承DbContext的具体类，你的ApiAuthDbContext是具体类，会被框架识别为独立的上下文实例，和ApiDbContext形成冲突。下面是具体解决方案：

1. 消除多DbContext冲突：将ApiAuthDbContext设为抽象类 #

把类库中的ApiAuthDbContext标记为抽象类，这样EF Core不会将它视为可实例化的DbContext，只会识别最终的ApiDbContext：

// 类库中的ApiAuthDbContext（抽象类，仅做继承用）
public abstract class ApiAuthDbContext : IdentityDbContext<ApiUser>
{
    protected ApiAuthDbContext(DbContextOptions options) : base(options)
    {
    }
}

// 应用项目中的ApiDbContext（唯一被实例化的上下文）
public class ApiDbContext : ApiAuthDbContext
{
    public ApiDbContext(DbContextOptions<ApiDbContext> options) : base(options)
    {
    }

    // 自定义实体DbSet放在这里
    public DbSet<YourCustomEntity> CustomEntities { get; set; }
}

2. 显式绑定Identity到ApiDbContext #

在Program.cs注册Identity服务时，明确指定使用ApiDbContext作为存储上下文，避免框架自动扫描时出现歧义：

// 注册ApiDbContext
builder.Services.AddDbContext<ApiDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

// 注册Identity并指定上下文
builder.Services.AddIdentityCore<ApiUser>(options =>
{
    // 按需配置Identity规则，比如密码、锁定策略等
    options.Password.RequireNonAlphanumeric = false;
})
.AddEntityFrameworkStores<ApiDbContext>();

3. 隐藏ApiUser：封装Identity注册逻辑 #

将ApiUser设为类库的internal访问修饰符，同时在类库中提供扩展方法封装Identity的注册流程，让应用项目无需直接引用ApiUser：

// 类库中的ApiUser（internal，仅类库内部可见）
internal class ApiUser : IdentityUser
{
    // 自定义用户属性
    public string? NickName { get; set; }
}

// 类库中的扩展方法（对外暴露的入口）
public static class ApiIdentityExtensions
{
    public static IServiceCollection AddApiIdentity(this IServiceCollection services, IConfiguration config)
    {
        // 注册上下文
        services.AddDbContext<ApiDbContext>(options =>
            options.UseSqlServer(config.GetConnectionString("DefaultConnection")));

        // 注册Identity，内部引用ApiUser
        services.AddIdentityCore<ApiUser>(options =>
        {
            options.SignIn.RequireConfirmedAccount = false;
            options.Password.RequireDigit = true;
        })
        .AddEntityFrameworkStores<ApiDbContext>()
        .AddDefaultTokenProviders();

        return services;
    }
}

应用项目的Program.cs只需调用扩展方法即可，完全无需接触ApiUser：

builder.Services.AddApiIdentity(builder.Configuration);

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