ASP.NET Web API：用户Email Claim始终返回空值的问题

你的问题核心是：JWT生成时email Claim明明存在于Payload中，但在受保护路由中无法通过User.FindFirst("email")获取到，而其他自定义Claim（name、id）正常。这通常是ASP.NET Core JWT身份验证中间件的Claim类型映射机制导致的。

原因分析 #

默认情况下，ASP.NET Core的JWT Bearer中间件会将JWT中的标准Claim名称（如email）自动映射到官方定义的Claim类型URI（比如http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress，对应ClaimTypes.Email常量）。这就导致你生成Token时用的自定义email Claim类型，在解析后被转换成了标准类型，因此用原字符串"email"无法找到对应的Claim。

解决方案 #

方案1：使用标准Claim类型生成与获取 #

生成Token时，直接使用ClaimTypes.Email作为Claim类型，而不是自定义字符串：

List<Claim> claims = new()
{
    new Claim("name", userModel.UserName),
    new Claim(ClaimTypes.Email, userModel.Email), // 使用标准类型
    new Claim("id", userModel.Id),
};

在受保护Action中，通过ClaimTypes.Email获取值：

var userEmailClaim = User.FindFirst(ClaimTypes.Email);
if (userEmailClaim != null)
{
    var userEmail = userEmailClaim.Value;
    Console.WriteLine($"userEmail {userEmail}");
}

方案2：禁用/修改Claim类型映射 #

如果你希望保留自定义的"email" Claim名称，可以在JWT中间件配置中清空或修改默认的Claim类型映射。在Program.cs的身份验证配置中添加如下代码：

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = builder.Configuration["JWT:ValidIssuer"],
            ValidAudience = builder.Configuration["JWT:ValidAudience"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(builder.Configuration["JWT:Secret"]))
        };

        // 清空默认Claim类型映射，保留Token中的原Claim名称
        options.ClaimTypeMap.Clear();
        // 可选：仅保留特定映射，比如让"email"保持原名称
        // options.ClaimTypeMap["email"] = "email";
    });

配置完成后，你就可以继续用User.FindFirst("email")获取对应的Claim值。

验证步骤 #

为了确认Claim的实际类型，你可以在受保护Action中打印所有Claim的详细信息：

foreach (var claim in User.Claims)
{
    Console.WriteLine($"Claim Type: {claim.Type}, Value: {claim.Value}");
}

通过输出结果，你可以直观看到email对应的Claim类型，从而调整获取方式。

内容的提问来源于stack exchange，提问作者m3.b