从AuthenticationStateProvider获取UserID及AspNetCore Identity GUID适配问题

问题原因梳理 #

• 现有代码直接取Claims集合第一条数据，无法保证拿到的是用户ID声明，多数情况下第一条会是用户名、角色类的其他声明，自然解析GUID失败
• AspNetCore Identity默认用户主键类型为string，和你自定义User模型的Guid类型未对齐，导致取出的ID格式不匹配

正确实现方案 #

方案1：对齐Identity主键类型为Guid（推荐，根源解决类型不匹配） #

无需修改现有业务表的UserID字段，仅调整Identity配置将默认用户主键类型设为Guid即可：

1. 自定义Identity用户类，继承泛型版本的IdentityUser

public class AppUser : IdentityUser<Guid>
{
    // 可在此添加自定义扩展字段
}

2. Program.cs中注册Identity时指定主键类型

builder.Services.AddDefaultIdentity<AppUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<YourDbContext>()
    .AddDefaultTokenProviders();

3. 数据库上下文继承对应泛型版本

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

调整后执行迁移即可将AspNetUsers表的Id字段类型更新为Guid对应的数据库类型，后续Identity生成的用户ID本身就是Guid类型，声明中存储的用户ID也是标准Guid字符串格式。

方案2：正确从Claims中提取用户ID #

无论是否调整Identity主键类型，都必须明确取约定存储用户ID的ClaimTypes.NameIdentifier声明，调整你的组件代码如下：

@inject AuthenticationStateProvider GetAuthenticationStateAsync
@using System.Security.Claims

private Todo todoItem { get; set; } = new Todo ();

protected override async Task OnInitializedAsync()
{
    todoItem.owningUser = new User();
    var authstate = await GetAuthenticationStateAsync.GetAuthenticationStateAsync();
    var user = authstate.User;
    // 明确筛选用户ID声明
    var userIdClaim = user.Claims.FirstOrDefault(c => c.Type == ClaimTypes.NameIdentifier);
    if (userIdClaim != null && Guid.TryParse(userIdClaim.Value, out var userId))
    {
        todoItem.owningUser.UserId = userId;
    }
    else
    {
        // 此处可添加未登录场景的处理逻辑，比如跳转登录页
    }
}

不可修改Identity表结构的兼容方案 #

如果现有AspNetUsers表的Id已经是string类型且存量数据不是GUID格式，可以在你的自定义User表新增IdentityUserId字段关联AspNetUsers表的Id，创建用户时生成自定义User的Guid UserId和Identity用户Id做映射，后续获取到Identity用户ID后查询映射关系即可拿到对应的Guid UserID。

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