Swashbuckle中HttpStatusCode.OK的SwaggerResponse UI不显示问题

我之前维护.NET Framework 4.7项目用Swashbuckle 5.x的时候，也碰到过一模一样的问题——swagger.json里明明有200响应的配置，但UI就是只展示4xx、5xx这类错误状态码的响应。结合你的情况，大概率是Swashbuckle的默认行为和手动注解冲突，或者旧版本的渲染bug导致的，给你几个排查和解决的方向：

1. 处理Swashbuckle的默认200响应生成逻辑 #

Swashbuckle 5.x会自动为返回非void类型的控制器Action生成一个默认的200响应，如果你手动添加了[SwaggerResponse(HttpStatusCode.OK)]，就会出现重复的200响应定义，而旧版本的Swagger UI（Swashbuckle 5.6.0自带的是UI 2.x）会因为解析冲突，直接隐藏掉这个响应。

解决办法是自定义一个OperationFilter，移除自动生成的默认200响应，只保留你手动配置的：

首先创建过滤器类：

public class RemoveDefaultOkResponseFilter : IOperationFilter
{
    public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
    {
        // 检查当前Action是否手动添加了OK的SwaggerResponse
        var manualOkResponse = apiDescription
            .GetControllerAndActionAttributes<SwaggerResponseAttribute>()
            .FirstOrDefault(a => a.StatusCode == (int)HttpStatusCode.OK);

        if (manualOkResponse != null && operation.responses.ContainsKey("200"))
        {
            // 替换自动生成的200响应为手动配置的内容
            operation.responses["200"] = new Response
            {
                description = manualOkResponse.Description,
                schema = schemaRegistry.GetOrRegister(manualOkResponse.Type)
            };
        }
    }
}

然后在SwaggerConfig.cs里注册这个过滤器：

GlobalConfiguration.Configuration
    .EnableSwagger(c =>
    {
        // 其他Swagger配置...
        c.OperationFilter<RemoveDefaultOkResponseFilter>();
    })
    .EnableSwaggerUi(c =>
    {
        // UI相关配置...
    });

2. 升级Swashbuckle到5.x最新版本 #

Swashbuckle 5.6.0存在一些已知的UI渲染bug，其中就包括200响应不显示的问题。你可以尝试升级到5.x系列的最后一个稳定版本（5.6.3），很多这类小问题都在后续版本里被修复了。

3. 排查浏览器缓存和UI渲染设置 #

有时候浏览器会缓存旧的swagger.json或者Swagger UI资源，导致新的配置不生效。你可以：

• 按Ctrl+Shift+R强制刷新页面
• 清空浏览器的缓存后重新加载
• 检查Swagger UI右上角的设置（比如Default Model Expand Depth），确保没有把响应内容折叠隐藏

4. 确认控制器方法返回类型与注解匹配 #

如果你的控制器方法返回的是IHttpActionResult或者HttpResponseMessage，而不是直接返回MyModel类型，要确保[SwaggerResponse]里指定的typeof(MyModel)和实际返回的模型完全一致。比如你例子里的ClientResultsCollectionModel<ResultsModel>，要确认这个泛型类型已经被Swashbuckle正确识别（你的swagger.json里已经有这个定义，所以这个可能性较低，但可以再核对一遍）。

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