.NET 6 Identity中GetUserAsync返回null但FindByNameAsync可用的原因

我在使用.NET 6和Identity框架获取当前用户时遇到问题：
下面的代码能正常返回用户实例：

return await _userManager.FindByNameAsync(_httpContextAccessor.HttpContext.User.Identity.Name);

但调用GetUserAsync方法始终返回null：

return await _userManager.GetUserAsync(_httpContextAccessor.HttpContext.User);

附最简代码示例 #

获取当前用户的方法 #

public async Task<AppUser> GetCurrentUserAsync()
{           
    if (_httpContextAccessor.HttpContext.User.Identity.Name == null)
    {
        return null;
    }

    return await _userManager.FindByNameAsync(_httpContextAccessor.HttpContext.User.Identity.Name);

    // 下方代码返回null
    // return await _userManager.GetUserAsync(_httpContextAccessor.HttpContext.User);
}

AppUser类定义 #

public class AppUser : IdentityUser
{
    public string ISO2Country { get; set; }
}

原因分析 #

GetUserAsync并非通过用户名查询用户，它依赖ClaimsPrincipal中的NameIdentifier Claim（即用户唯一ID）来匹配数据库中的用户。返回null通常是以下几种情况导致：

• HttpContext.User的Claim集合中缺失NameIdentifier：Identity默认在认证成功后，会将用户的ID存入NameIdentifier类型的Claim，若该Claim丢失，方法就无法定位到用户。
• 认证方案不匹配：如果应用同时使用多种认证方案（如Cookie+JWT），当前HttpContext.User使用的认证方案未包含Identity所需的完整Claim集合。
• UserManager配置异常：UserManager<AppUser>的存储提供者（比如EF Core上下文）配置错误，比如用户ID类型不匹配（默认是string，若自定义为其他类型但未同步配置）。

解决方法 #

1. 检查Claim集合
   在调用GetUserAsync前，调试查看_httpContextAccessor.HttpContext.User.Claims，确认是否存在类型为http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier的Claim，且其值与数据库中用户的ID一致。

2. 确认认证中间件配置
   在Program.cs中保证Identity认证中间件顺序正确，且默认认证方案为Identity的Cookie方案：

   // 先注册认证，再注册授权
   app.UseAuthentication();
   app.UseAuthorization();
   
   // 确保Identity服务配置正确
   builder.Services.AddDefaultIdentity<AppUser>(options => options.SignIn.RequireConfirmedAccount = true)
       .AddEntityFrameworkStores<ApplicationDbContext>();
   

3. 临时替代方案
   如果暂时无法修复Claim问题，可以手动提取用户ID后查询：

   var userId = _httpContextAccessor.HttpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
   if (userId == null) return null;
   return await _userManager.FindByIdAsync(userId);
   

内容的提问来源于stack exchange，提问作者Sylvain C.