如何在配置默认Identity的ASP.NET Core项目中使用AspNet*表导航属性

你遇到的模型重复异常，本质是因为IdentityDbContext基类已经内置了所有AspNet*系列表对应的实体配置和DbSet属性，你手动在上下文里重复添加相同实体的DbSet就会触发冲突，无需手动添加，直接用基类预置的能力即可，具体方案如下：

方案1：直接使用内置Identity实体（推荐，覆盖90%常规场景） #

不需要手动在ApplicationDbContext中加AspNet*表对应的DbSet，直接用内置的Identity类型声明导航属性即可：

• 业务实体关联AspNet*表示例：

// 示例业务实体，关联AspNetUsers表
public class BusinessOrder
{
    public int Id { get; set; }
    public string OrderNumber { get; set; }
    // 对应AspNetUsers表的主键Id
    public string UserId { get; set; }
    // 导航属性直接使用内置IdentityUser类型
    public IdentityUser User { get; set; }
}

• 可以直接通过上下文的内置属性访问所有AspNet*表：

// 访问AspNetUsers表
var user = await _dbContext.Users.FirstOrDefaultAsync(u => u.Id == "用户Id");
// 访问AspNetRoles表
var role = await _dbContext.Roles.FirstOrDefaultAsync(r => r.Name == "管理员");

• 如果需要给用户表扩展自定义字段，替换为自定义用户类型即可：

1. 定义自定义用户类继承IdentityUser

public class ApplicationUser : IdentityUser
{
    // 新增自定义字段
    public string NickName { get; set; }
    public DateTime RegisterTime { get; set; }
}

2. 修改上下文的继承声明

public partial class ApplicationDbContext : IdentityDbContext<ApplicationUser>
{
    // 原有构造函数、业务表DbSet、OnModelCreating代码不变
}

3. 修改Identity服务注册代码

services.AddIdentity<ApplicationUser, IdentityRole>(options => { /* 原有配置不变 */ })
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

之后业务实体的导航属性替换为ApplicationUser类型，就能直接访问你扩展的自定义字段。

方案2：完全自定义Identity实体（仅特殊场景使用） #

如果你需要完全修改AspNet*系列表的表名、字段名、结构，不受Identity内置约束，可以按以下方式操作：

• 上下文不继承IdentityDbContext，直接继承DbContext
• 自行定义所有Identity相关的实体（User、Role、UserClaim、UserRole、UserLogin等），自行在OnModelCreating中配置表结构、主键、关联关系
• 注册Identity时替换为自定义的实体类型，同时配置Identity使用自定义的存储实现，该方案改造成本较高，无特殊需求不建议使用。

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