在Swagger中为未授权请求指定空Content-Type的方法问询

方案一：让Swagger正确标记无Content-Type的401响应 #

默认情况下，即便你只声明.Produces(401)，Swagger仍会自动为该状态码添加application/json类型，这和.NET实际返回的无Content-Type的401响应不符。要修正这个差异，可通过自定义Swagger文档过滤器实现：

1. 创建实现IDocumentFilter的过滤器类：

using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;

public class Remove401ContentTypeFilter : IDocumentFilter
{
    public void Apply(OpenApiDocument swaggerDoc, DocumentFilterContext context)
    {
        foreach (var path in swaggerDoc.Paths.Values)
        {
            foreach (var operation in path.Operations.Values)
            {
                if (operation.Responses.TryGetValue("401", out var response))
                {
                    // 清空401响应的所有Content-Type声明
                    response.Content.Clear();
                }
            }
        }
    }
}

2. 在Program.cs中注册该过滤器：

builder.Services.AddSwaggerGen(c =>
{
    c.DocumentFilter<Remove401ContentTypeFilter>();
});

配置完成后，Swagger中的401响应将不再显示任何Content-Type，与.NET实际返回行为一致，ApiDog测试就不会因类型不匹配报错。

方案二：配置.NET让401返回JSON格式响应 #

如果你更倾向让.NET在返回401时输出标准JSON内容（比如{"status":"401"}），可通过自定义授权挑战逻辑或全局中间件实现：

方式1：自定义JWT授权挑战响应（适用于JWT认证场景） #

builder.Services.AddAuthorization();
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.Events = new JwtBearerEvents
        {
            OnChallenge = async context =>
            {
                // 阻止默认的401响应逻辑
                context.HandleResponse();
                
                // 设置响应状态码与Content-Type
                context.Response.StatusCode = StatusCodes.Status401Unauthorized;
                context.Response.ContentType = "application/json";
                
                // 写入自定义JSON内容
                var response = new { status = "401", message = "未授权访问" };
                await context.Response.WriteAsJsonAsync(response);
            }
        };
    });

方式2：全局中间件捕获并替换401响应 #

// 注意：该中间件需放在授权中间件之前注册
app.Use(async (context, next) =>
{
    await next();
    
    if (context.Response.StatusCode == StatusCodes.Status401Unauthorized 
        && string.IsNullOrEmpty(context.Response.ContentType))
    {
        context.Response.ContentType = "application/json";
        await context.Response.WriteAsJsonAsync(new { status = "401" });
    }
});

app.UseAuthorization();

配置后，.NET返回的401响应会带有application/json类型和指定JSON内容，与你通过.Produces(401)标记的Swagger文档完全匹配，ApiDog测试可正常通过。

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