WebApi中JWT Bearer Token验证失效，求助排查配置问题

可能的问题点及解决方法 #

1. 控制器未明确绑定认证Scheme #

尽管你已将默认认证Scheme设为JwtBearer，但部分场景下[Authorize]特性可能无法自动关联默认规则，导致认证逻辑未触发。修改控制器特性：

[Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme)]
public class ProtectedController : ControllerBase
{
    // 受保护的接口逻辑
}

2. Token生成的受众与服务端配置不匹配 #

你生成Token时使用的是客户端传入的user.Audience，但服务端验证依赖配置文件中的Jwt:Audience，两者必须完全一致才能通过验证。若需统一受众，修改Token生成代码：

var token = new JwtSecurityToken(
    config["Jwt:Issuer"],
    config["Jwt:Audience"], // 替换为服务端配置的固定受众
    new[] {
        new Claim("Id", Guid.NewGuid().ToString()),
        new Claim(JwtRegisteredClaimNames.Sub, user.Name),
        new Claim(JwtRegisteredClaimNames.Jti, Guid.NewGuid().ToString())
    },
    expires: DateTime.Now.AddSeconds(3600),
    signingCredentials: credentials);

3. 未启用认证事件日志排查问题 #

添加JwtBearer事件处理，捕获验证过程中的错误或成功日志，确认认证逻辑是否正常执行：

.AddJwtBearer(o =>
{
    // 原有配置...
    o.Events = new JwtBearerEvents
    {
        OnAuthenticationFailed = context =>
        {
            Console.WriteLine($"认证失败原因: {context.Exception.Message}");
            return Task.CompletedTask;
        },
        OnTokenValidated = context =>
        {
            Console.WriteLine("Token验证通过");
            return Task.CompletedTask;
        }
    };
});

4. 中间件配置不完整 #

确保UseEndpoints中间件在认证、授权之后配置，否则请求无法路由到控制器，认证逻辑不会触发：

app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
// 必须添加端点路由配置
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

5. 验证JWT密钥合规性 #

HmacSha256算法要求密钥长度至少为128位（16字节），若Jwt:Key过短会导致验证失败。确保密钥为至少16个字符的随机字符串。

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