ASP.NET Core 2.0 Web API中Swashbuckle未携带Authorization头问题求助

嘿，我之前在ASP.NET Core 2.0项目里也碰到过一模一样的问题——Swagger UI里能看到Basic Auth选项，填了账号密码，但调用API时Authorization头就是不发出去。后来折腾了几个配置才搞定，给你详细说说：

1. 给Swagger生成器添加全局安全要求 #

光定义认证方案还不够，得明确告诉Swagger哪些API需要携带这个认证头。在AddSwaggerGen里补充安全要求配置：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new Info { Title = "你的API名称", Version = "v1" });

    // 定义Basic认证方案
    c.AddSecurityDefinition("basic", new ApiKeyScheme
    {
        Name = "Authorization",
        Type = "apiKey",
        Scheme = "basic",
        In = "header",
        Description = "输入用户名和密码完成Basic认证"
    });

    // 核心：给所有API添加安全要求，确保Swagger UI自动携带认证头
    c.AddSecurityRequirement(new Dictionary<string, IEnumerable<string>>
    {
        { "basic", new string[] {} }
    });
});

2. 自定义操作过滤器（可选但推荐） #

ASP.NET Core 2.0的Swashbuckle版本有时候对[Authorize]属性的识别不够灵敏，写个操作过滤器能确保带认证要求的API强制发送头：

public class BasicAuthOperationFilter : IOperationFilter
{
    public void Apply(Operation operation, OperationFilterContext context)
    {
        // 检查当前API或控制器是否加了[Authorize]属性
        var hasAuthorizeAttr = context.MethodInfo.DeclaringType.GetCustomAttributes(true)
            .Union(context.MethodInfo.GetCustomAttributes(true))
            .OfType<AuthorizeAttribute>()
            .Any();

        if (hasAuthorizeAttr)
        {
            // 添加401/403响应说明
            operation.Responses.Add("401", new Response { Description = "未授权访问" });
            operation.Responses.Add("403", new Response { Description = "无权限访问" });

            // 确保安全要求被添加到当前操作
            if (operation.Security == null)
                operation.Security = new List<IDictionary<string, IEnumerable<string>>>();

            operation.Security.Add(new Dictionary<string, IEnumerable<string>>
            {
                { "basic", new string[] {} }
            });
        }
    }
}

然后在AddSwaggerGen里注册这个过滤器：

c.OperationFilter<BasicAuthOperationFilter>();

3. 检查中间件顺序 #

一定要保证认证中间件在Swagger中间件之前执行，不然Swagger处理请求时还没触发认证逻辑，头的传递会出问题。在Configure方法里按这个顺序写：

app.UseAuthentication(); // 先加认证中间件
app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API V1");
});

4. 确认Swagger UI的授权操作 #

最后别忘了一个小细节：在Swagger UI里点击右上角的「Authorize」按钮，输入账号密码后一定要点击「Authorize」按钮确认，而不是输入完就关闭弹窗——只有确认后，Swagger才会把认证头附加到后续的API请求里。

按这几步配置完，你再测试一下API调用，Authorization头应该就能正常发送到控制器了。

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