使用Auth0与JWT时JwtSecurityTokenHandler返回小写Claim类型问题

我完全懂你遇到的困扰——你明明在构建JWT时用了大写的Claim名称，结果经过JwtSecurityTokenHandler解析成JwtSecurityToken后，所有Claim的类型全变成小写了。这其实是.NET的JwtSecurityTokenHandler自带的默认行为在搞鬼，它会自动对JWT声明做规范化映射，哪怕是你自定义的大写Claim，也可能被默认规则转成小写。下面给你几个实用的解决办法：

方案1：直接禁用Claim入站映射（最省心） #

你只需要把JwtSecurityTokenHandler的MapInboundClaims属性设为false，就能阻止它自动转换Claim类型，完全保留你原本设置的大小写格式。

示例代码：

var handler = new JwtSecurityTokenHandler();
handler.MapInboundClaims = false; // 关键设置，关闭自动映射

// 解析令牌
var jwtToken = handler.ReadJwtToken(yourTokenString);

这样处理后，jwtToken.Claims里每个Claim的Type属性，就和你生成令牌时设置的大小写完全一致了。

方案2：自定义Claim类型映射（按需保留） #

如果你只想保留部分大写Claim的格式，其他标准JWT声明还需要正常映射，可以手动清除默认规则，再添加自定义映射：

var handler = new JwtSecurityTokenHandler();
// 清空默认的映射规则
handler.InboundClaimTypeMap.Clear();
// 给自定义大写Claim添加映射，保留原格式
handler.InboundClaimTypeMap.Add("YOUR_CUSTOM_CLAIM", "YOUR_CUSTOM_CLAIM");
// 也可以让标准声明保留原始名称（比如你想把sub改成SUB的话，直接写"SUB"）
handler.InboundClaimTypeMap.Add("SUB", "SUB");
handler.InboundClaimTypeMap.Add("EMAIL", "EMAIL");

// 解析令牌
var jwtToken = handler.ReadJwtToken(yourTokenString);

补充：生成令牌时的注意事项 #

从你给出的BuildToken代码片段来看，你用了JwtRegisteredClaimNames里的常量——要注意这些常量的值本身就是小写的（比如JwtRegisteredClaimNames.Sub对应的值是"sub"）。如果希望标准声明也用大写，得手动写大写字符串作为Claim的Type，而不是用这些常量：

private string BuildToken(UserModel user) {
    var claims = new[] {
        new Claim("SUB", user.Name), // 手动设置大写的Claim类型
        new Claim("EMAIL", user.Email),
        new Claim("BIRTHDATE", user.Birthdate.ToString())
        // 其他自定义大写Claim...
    };

    // 后续令牌生成逻辑
    var tokenDescriptor = new SecurityTokenDescriptor {
        Subject = new ClaimsIdentity(claims),
        Expires = DateTime.UtcNow.AddHours(1),
        SigningCredentials = new SigningCredentials(yourSecurityKey, SecurityAlgorithms.HmacSha256Signature)
    };

    var handler = new JwtSecurityTokenHandler();
    var token = handler.CreateToken(tokenDescriptor);
    return handler.WriteToken(token);
}

这样生成的令牌里Claim类型都是大写，再配合前面的MapInboundClaims = false设置，解析后就能完美保留你想要的格式了。

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