如何向AspNetUserRoles表新增userId、roleId记录及删除指定行

AspNetUserRoles是ASP.NET Core Identity框架自动维护的用户-角色关联表，默认无需手动定义对应实体，框架已封装了IdentityUserRole<TKey>作为该表的对应实体，同时提供了两种操作方式：

新增指定userId和roleId的关联记录 #

方式1：使用官方封装的UserManager操作（推荐） #

无需手动操作实体，框架会自动校验并插入记录，代码示例：

// 构造函数注入UserManager，泛型参数为你的用户实体类，默认是IdentityUser
private readonly UserManager<IdentityUser> _userManager;
private readonly RoleManager<IdentityRole> _roleManager;

public async Task AddUserRole(string userId, string roleId)
{
    // 先校验用户和角色是否存在
    var user = await _userManager.FindByIdAsync(userId);
    var role = await _roleManager.FindByIdAsync(roleId);
    if (user == null || role == null) return;

    // 执行新增操作
    var result = await _userManager.AddToRoleAsync(user, role.Name);
    if (result.Succeeded)
    {
        // 新增成功逻辑
    }
}

方式2：直接操作实体+DbContext #

如果需要直接操作表记录，可以直接实例化IdentityUserRole<TKey>实体操作，代码示例：

// 构造函数注入你的自定义DbContext
private readonly YourAppDbContext _dbContext;

public async Task AddUserRoleDirectly(string userId, string roleId)
{
    // TKey替换为你实际的主键类型，默认是string，如果你配置的是int就改为IdentityUserRole<int>
    var userRoleEntity = new IdentityUserRole<string>
    {
        UserId = userId,
        RoleId = roleId
    };

    _dbContext.Set<IdentityUserRole<string>>().Add(userRoleEntity);
    await _dbContext.SaveChangesAsync();
}

删除AspNetUserRoles表指定行 #

方式1：使用UserManager操作（推荐） #

public async Task RemoveUserRole(string userId, string roleId)
{
    var user = await _userManager.FindByIdAsync(userId);
    var role = await _roleManager.FindByIdAsync(roleId);
    if (user == null || role == null) return;

    var result = await _userManager.RemoveFromRoleAsync(user, role.Name);
    if (result.Succeeded)
    {
        // 删除成功逻辑
    }
}

方式2：直接操作DbContext删除 #

public async Task RemoveUserRoleDirectly(string userId, string roleId)
{
    var toDelete = await _dbContext.Set<IdentityUserRole<string>>()
        .FirstOrDefaultAsync(ur => ur.UserId == userId && ur.RoleId == roleId);
    if (toDelete == null) return;

    _dbContext.Set<IdentityUserRole<string>>().Remove(toDelete);
    await _dbContext.SaveChangesAsync();
}

注意事项 #

• 优先使用UserManager/RoleManager的封装方法，会自动触发校验、权限更新、缓存同步等逻辑，避免出现数据不一致问题
• 如果自定义了Identity主键类型，需要将IdentityUserRole<string>中的泛型参数替换为你实际使用的主键类型（如int、Guid）

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