如何在C#中读取JWT令牌数据并保证类型正确

JWT Payload中的原始数据虽然带有类型信息，但JwtSecurityTokenHandler解析后，Claims集合里的所有值都会被统一处理为字符串类型——这就是你遇到布尔值变成"true"/"false"、数值变成字符串的原因。下面提供两种可靠的解决方法：

方法一：手动转换目标字段类型 #

针对单个需要类型转换的Claim，直接使用对应类型的解析方法（比如bool.TryParse）将字符串值转换为目标类型，避免直接用字符串比较：

string token = HttpContext.Request.Headers["Authorization"].ToString().Replace("Bearer ", "");
var jwtToken = new JwtSecurityTokenHandler().ReadToken(token) as JwtSecurityToken;
var firstAccessStr = jwtToken.Claims.FirstOrDefault(c => c.Type == "first_access")?.Value;

// 安全解析布尔值，避免空值或非法格式抛出异常
if (bool.TryParse(firstAccessStr, out bool firstAccess) && !firstAccess)
    return BadRequest(new { message = ErrorMessages.ChangePasswordDenied });

这种方法适合只需要处理少量字段的场景，简单直接。

方法二：反序列化Payload到强类型对象 #

如果需要处理多个带类型的字段，更优雅的方式是将整个JWT Payload反序列化为预先定义的实体类，自动保留原始类型信息：

1. 定义与Payload结构匹配的实体类：

public class JwtUserPayload
{
    [JsonPropertyName("id")]
    public int Id { get; set; }
    
    [JsonPropertyName("first_access")]
    public bool FirstAccess { get; set; }
    
    [JsonPropertyName("nbf")]
    public long NotBefore { get; set; }
    
    [JsonPropertyName("exp")]
    public long Expires { get; set; }
    
    [JsonPropertyName("iat")]
    public long IssuedAt { get; set; }
}

2. 反序列化Payload并使用：

string token = HttpContext.Request.Headers["Authorization"].ToString().Replace("Bearer ", "");
var handler = new JwtSecurityTokenHandler();
var jwtToken = handler.ReadToken(token) as JwtSecurityToken;

// 将Payload序列化为JSON字符串，再反序列化为强类型对象
var payload = JsonSerializer.Deserialize<JwtUserPayload>(jwtToken.Payload.SerializeToJson());

if (!payload.FirstAccess)
    return BadRequest(new { message = ErrorMessages.ChangePasswordDenied });

这种方法的优势是类型安全，后续维护和扩展更方便，适合包含多个类型字段的JWT场景。

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