在数字化时代，JWT（JSON Web Token）已成为身份验证和授权的常用工具。然而，当您尝试使用 JwtSecurityTokenHandler 解码 JWT 令牌时，可能会遇到“字符串需要采用紧凑 JSON 格式”的错误。别担心，本文将为您提供详细的解决方案和示例代码，帮助您轻松搞定这个问题。

什么是 JwtSecurityTokenHandler？

JwtSecurityTokenHandler 是 .NET 框架中用于处理 JWT 令牌的安全类。它提供了一种安全的方式来解析和验证 JWT 令牌的内容。然而，使用这个类时，您需要确保输入的字符串采用特定的格式：Base64UrlEncodedHeader.Base64UrlEncodedPayload.OPTIONAL,Base64UrlEncodedSignature。

解码 JWT 令牌的常见错误

当您尝试使用 JwtSecurityTokenHandler 解码 JWT 令牌时，可能会遇到以下错误：

1. 字符串需要采用紧凑 JSON 格式：这意味着输入的 JWT 字符串没有按照指定的格式进行编码。

2. 无效的签名：JWT 令牌的签名无效，导致解析失败。

解决方案

方法一：强制转换方法

使用强制转换方法将字符串转换为 JwtSecurityToken 类型。以下是示例代码：

var stream = "[encoded jwt]";
var handler = new JwtSecurityTokenHandler();
var jsonToken = handler.ReadToken(stream);
var tokenS = jsonToken as JwtSecurityToken;

if (tokenS != null)
{
    // 现在可以使用 tokenS.Claims 访问声明
    var jti = tokenS.Claims.First(claim => claim.Type == "jti").Value;
    Console.WriteLine($"jti: {jti}");
}
else
{
    Console.WriteLine("无法解析 JWT 令牌");
}

方法二：使用 ReadJwtToken 方法

使用 ReadJwtToken 方法直接读取令牌，并返回一个 JwtSecurityToken 对象。以下是示例代码：

var token = "[encoded jwt]";
var handler = new JwtSecurityTokenHandler();
var jwtSecurityToken = handler.ReadJwtToken(token);

if (jwtSecurityToken != null)
{
    // 使用 jwtSecurityToken 对象访问声明
    var jti = jwtSecurityToken.Claims.First(claim => claim.Type == "jti").Value;
    Console.WriteLine($"jti: {jti}");
}
else
{
    Console.WriteLine("无法解析 JWT 令牌");
}

检索声明

正确解码令牌后，您可以使用以下方式检索声明：

var jti = tokenS.Claims.First(claim => claim.Type == "jti").Value;
Console.WriteLine($"jti: {jti}");

注意事项

1. 确保输入格式正确：在使用 JwtSecurityTokenHandler 解码 JWT 令牌时，必须确保输入的字符串采用指定的格式（Base64UrlEncodedHeader.Base64UrlEncodedPayload.OPTIONAL,Base64UrlEncodedSignature）。

2. 验证签名：在解码令牌之前，建议先验证令牌的签名，以确保令牌的完整性和安全性。

3. 处理异常：在解码过程中，可能会遇到各种异常情况。建议使用 try-catch 块来捕获和处理这些异常。

通过本文的介绍，相信您已经掌握了如何使用 JwtSecurityTokenHandler 解码 JWT 令牌并解决“紧凑 JSON 格式”错误的方法。更多关于 JWT 和 JwtSecurityTokenHandler 的信息，请关注 PHP 中文网的其他相关文章！

希望本文能为您在处理 JWT 令牌时提供帮助和指导！