ASP.NET MVC API中HttpContext.User.Claims为空但JWT含声明的问题

1. 修复中间件顺序 #

你的代码里缺少UseAuthentication中间件，且它必须放在UseAuthorization之前——这个中间件负责解析请求中的JWT Token并填充HttpContext.User.Claims，没有它的话，后续授权和用户声明读取都无法正常工作。

修改后的启动代码：

var app = builder.Build(); 
app.UseHttpsRedirection();
app.UseAuthentication(); // 必须添加，且在UseAuthorization之前
app.UseAuthorization();
app.MapControllers();
app.Run();

2. 完善JWT验证参数配置 #

当前的TokenValidationParameters还缺少几个关键的关闭项，导致中间件依然会因为某些规则不通过而拒绝解析Token。补充以下配置：

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddJwtBearer(JwtBearerDefaults.AuthenticationScheme,
    options => {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            RequireExpirationTime = false,
            RequireSignedTokens = false,
            RequireAudience = false,
            SaveSigninToken = false,
            TryAllIssuerSigningKeys = false,
            ValidateActor = false,
            ValidateAudience = false,
            ValidateIssuer = false, // 关闭Issuer验证
            ValidateLifetime = false, // 关闭Token有效期验证（即使无exp声明也能通过）
            ValidateIssuerSigningKey = false // 关闭签名密钥验证
        };
        // 注意：如果你的JwtSettings配置会覆盖TokenValidationParameters，建议先Bind再手动修改参数
        builder.Configuration.Bind("JwtSettings", options);
    });

3. 端点添加[Authorize]特性 #

只有添加[Authorize]，中间件才会强制触发Token解析流程（否则中间件可能跳过解析，导致HttpContext.User为空）。修改后的控制器代码：

[ApiController]
[Route("api/[controller]")]
public class TestController : ControllerBase
{
    [HttpGet]
    [Route("testclaims")]
    [Authorize] // 添加这个特性
    public async Task<ActionResult<string?>> TestClaims()
    {
        List<string> result = new List<string>();
        foreach (var claim in HttpContext.User.Claims)
            result.Add($"{claim.Type}: {claim.Value}");

        return "{" + String.Join(", ", result.ToArray()) + "}";
    }
}

4. 开启调试日志（可选） #

如果仍有问题，开启JWT认证的调试日志，能帮你排查Token解析失败的具体原因。在appsettings.json中添加：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.Authentication.JwtBearer": "Debug"
    }
  }
}

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