生成匹配.NET Core的JWT遇401验证失败，求解决方法

问题背景 #

对接第三方API时，对方使用.NET Core进行JWT验证，验证代码如下：

using System;
using System.Text;
using Microsoft.IdentityModel.Tokens;
using Microsoft.AspNetCore.Builder;

// 密钥长度需足够，否则会报错
var tokenSecretKey = Encoding.UTF8.GetBytes(Configuration["TokenSecretKey"]);

var tokenValidationParameters = new TokenValidationParameters
{
    // 使用密钥验证令牌签名
    ValidateIssuerSigningKey = true,
    IssuerSigningKey = new SymmetricSecurityKey(tokenSecretKey),
    ValidateIssuer = false,
    ValidateAudience = false
};

services.AddAuthentication(options =>
        {
            options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
            options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
        }).AddJwtBearer(options => { 
            options.RequireHttpsMetadata = false;
            options.SaveToken = true; 
            options.TokenValidationParameters = tokenValidationParameters; 
        });

我在.NET 4.0环境下使用Jose JWT库生成令牌，代码如下：

return Jose.JWT.Encode(claims, byteArrayOfKey, Jose.JwsAlgorithm.HS256);

但服务器端返回401验证失败，需调整生成逻辑匹配对方配置。

排查与修复步骤 #

1. 确保密钥编码完全一致 #

服务器端通过Encoding.UTF8.GetBytes(密钥字符串)将密钥转为字节数组，客户端必须使用完全相同的密钥字符串，并通过UTF8编码转为字节数组，不能使用ASCII、Unicode等其他编码，也不能直接使用自定义字节数组（除非与服务器端UTF8编码结果完全一致）。

修正示例：

// 替换为第三方提供的密钥字符串
string secretKey = "第三方提供的密钥内容";
byte[] byteArrayOfKey = Encoding.UTF8.GetBytes(secretKey);
return Jose.JWT.Encode(claims, byteArrayOfKey, Jose.JwsAlgorithm.HS256);

2. 强制添加令牌有效期声明 #

.NET Core的JWT验证默认启用ValidateLifetime = true（代码中未显式关闭），如果生成的令牌没有包含exp（过期时间）声明，或声明的时间已过期，会直接验证失败。

需在claims中添加有效期声明，示例：

var claims = new Dictionary<string, object>
{
    // 其他业务相关声明
    ["exp"] = DateTimeOffset.UtcNow.AddHours(1).ToUnixTimeSeconds() // 设置1小时有效期
};

3. 确认算法匹配 #

服务器端使用对称密钥验证，对应HMAC算法，你使用的Jose.JwsAlgorithm.HS256（HMAC-SHA256）是匹配的，需确保没有误选RS256等非对称算法。

4. 验证令牌格式正确性 #

使用本地JWT解码工具解析生成的令牌，检查：

• 签名部分无损坏
• Payload中的声明格式正确（无语法错误）
• exp时间设置符合预期

验证方法 #

生成令牌后，先通过解码工具确认结构无误，请求第三方API时，确保请求头中携带格式正确的认证信息：Authorization: Bearer 你的令牌内容

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