ASP.NET Core Identity添加用户角色时触发InvalidOperationException异常求助

异常信息 #

System.InvalidOperationException: 尝试保存更改时，'IdentityUserRole.RoleId'的值未知。这是因为该属性同时属于一个外键，而该关系中的主体实体未知。

注册方法代码 #

public async Task<OperationResult<RegisterResponseDto>> Register(RegisterBaseDto RegisterDto)
{
    var UserRole = await RoleManager.FindByIdAsync(RegisterDto.RoleId.ToString());
    if (UserRole == null) 
    {
        return OperationResult<RegisterResponseDto>.Failure("User Role Not Found.");
    }

    IdentityResult Result = null;
    AppUser? MappedUser = UserFactory.Create(UserRole, RegisterDto);

    if (MappedUser == null)
    {
        return OperationResult<RegisterResponseDto>.Failure("User Not Created.");
    }
    
    Result = await UserManager.CreateAsync(MappedUser, RegisterDto.Password);

    if (Result.Succeeded)
    {
        var mappedRegisterResponse = Mapper.Map<RegisterResponseDto>(MappedUser);
        var roleAssignmentResult = await UserManager.AddToRoleAsync(MappedUser, UserRole.Name);

        if (roleAssignmentResult.Succeeded)
        {
            return OperationResult<RegisterResponseDto>.Success(mappedRegisterResponse);
        }
        else { 
            return OperationResult<RegisterResponseDto>.Failure("User is not created, Please try again.");
        }
    }
    return OperationResult<RegisterResponseDto>.Failure("User is not created, Please try again.");
}

附加信息 #

• 使用ASP.NET Core 8、Entity Framework Core和ASP.NET Identity
• AppUser类继承自IdentityUser
• 异常在调用AddToRoleAsync方法时触发

已尝试操作 #

• 确认分配角色前，角色已存在于数据库中
• 验证数据库上下文配置正确，IdentityUserRole已正确配置
• 检查DbContext中的实体关系是否存在潜在问题

解决方案 #

原因分析 #

该异常本质是EF Core无法确认关联的Role实体是数据库中已存在的有效实体，导致创建用户-角色关联记录时，无法解析RoleId对应的主体角色状态。

方案1：将角色实体附加到上下文跟踪 #

获取角色后，手动将其附加到数据库上下文，明确告知EF Core该角色是已存在的实体：

var UserRole = await RoleManager.FindByIdAsync(RegisterDto.RoleId.ToString());
if (UserRole == null) 
{
    return OperationResult<RegisterResponseDto>.Failure("用户角色不存在。");
}
// 附加角色到上下文，标记为未修改状态
_context.Attach(UserRole).State = EntityState.Unchanged;

方案2：创建用户后重新获取实体 #

用户创建完成后，MappedUser的上下文跟踪状态可能异常，重新从数据库获取用户实体再执行角色分配：

Result = await UserManager.CreateAsync(MappedUser, RegisterDto.Password);

if (Result.Succeeded)
{
    // 重新获取数据库中的用户实体
    var createdUser = await UserManager.FindByIdAsync(MappedUser.Id);
    if (createdUser == null)
    {
        return OperationResult<RegisterResponseDto>.Failure("用户创建后无法查询到。");
    }
    var mappedRegisterResponse = Mapper.Map<RegisterResponseDto>(createdUser);
    var roleAssignmentResult = await UserManager.AddToRoleAsync(createdUser, UserRole.Name);
    
    if (roleAssignmentResult.Succeeded)
    {
        return OperationResult<RegisterResponseDto>.Success(mappedRegisterResponse);
    }
    else 
    { 
        return OperationResult<RegisterResponseDto>.Failure("用户角色分配失败，请重试。");
    }
}

方案3：确认Identity上下文配置正确性 #

确保DbContext正确继承并配置Identity相关实体：

public class AppDbContext : IdentityDbContext<AppUser, IdentityRole, string>
{
    public AppDbContext(DbContextOptions<AppDbContext> options) 
        : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        
        // 显式配置用户-角色关联表的外键关系
        builder.Entity<IdentityUserRole<string>>()
            .HasKey(ur => new { ur.UserId, ur.RoleId });
            
        builder.Entity<IdentityUserRole<string>>()
            .HasOne<IdentityRole>(r => r.Role)
            .WithMany(u => u.UserRoles)
            .HasForeignKey(ur => ur.RoleId);
            
        builder.Entity<IdentityUserRole<string>>()
            .HasOne<AppUser>(u => u.User)
            .WithMany(r => r.UserRoles)
            .HasForeignKey(ur => ur.UserId);
    }
}

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