ASP.NET Core 2.0中Swagger UI集成JWT授权后仍返回未授权求助

这个问题我之前在项目里也踩过坑——Postman能正常走授权但Swagger调用就返回401，核心原因是Swagger默认不会自动把你输入的令牌带到请求头里，得给Swagger添加上JWT的安全定义和全局安全要求配置才行。我给你梳理一下具体要补的代码和检查点：

1. 补充Swagger的JWT安全配置 #

在ConfigureServices的AddSwaggerGen方法里，你需要添加JWT的安全定义（告诉Swagger怎么识别Bearer令牌），以及全局安全要求（让所有接口请求都自动带上授权头）：

public void ConfigureServices(IServiceCollection services)
{
    // 你的其他服务注册代码...

    // 注册Swagger生成器
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new Info { Title = "你的API服务", Version = "v1" });

        // 新增：添加JWT安全定义
        c.AddSecurityDefinition("Bearer", new ApiKeyScheme
        {
            Description = "JWT授权格式：Bearer {token}，注意Bearer和令牌之间必须有空格",
            Name = "Authorization",
            In = "header",
            Type = "apiKey"
        });

        // 新增：添加全局安全要求，让所有接口都应用这个授权规则
        c.AddSecurityRequirement(new Dictionary<string, IEnumerable<string>>
        {
            { "Bearer", new string[] {} }
        });
    });

    // 确认JWT验证配置正确（Postman正常的话这块大概率没问题，但还是核对下参数）
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(options =>
        {
            options.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = true,
                ValidateAudience = true,
                ValidateLifetime = true,
                ValidateIssuerSigningKey = true,
                ValidIssuer = "你的Issuer配置", // 替换成实际的发行方
                ValidAudience = "你的Audience配置", // 替换成实际的受众
                IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("你的密钥")) // 替换成实际的签名密钥
            };
        });
}

2. 确认中间件执行顺序 #

在Configure方法里，必须保证UseAuthentication在UseMvc之前调用，否则授权验证逻辑不会先于接口执行：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 其他中间件代码（比如异常处理、静态文件等）...

    // 启用Swagger和Swagger UI
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API V1");
    });

    // 关键：授权中间件必须在Mvc中间件之前
    app.UseAuthentication();

    app.UseMvc();
}

3. 验证控制器的授权标记 #

确保你的控制器或目标方法上已经添加了[Authorize]属性，比如：

[Authorize]
[ApiController]
[Route("api/[controller]")]
public class DemoController : ControllerBase
{
    // 你的接口方法...
}

做完这些配置后，重启应用，在Swagger UI页面点击右上角的「Authorize」按钮，输入Bearer 你的JWT令牌（注意Bearer和令牌之间的空格），再调用接口就能正常通过授权了。

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