Web API使用Results<TResult1,TResultN>时Swagger UI未显示全部响应

你遇到的情况并非对文档理解有误，核心原因是Swagger生成工具（Swashbuckle.AspNetCore）的版本兼容性问题：

为什么会出现这个问题 #

微软文档中提到的Results<TResult1, TResultN>自动保留端点元数据，是ASP.NET Core 8框架本身的能力，但Swagger UI依赖的Swashbuckle.AspNetCore库需要专门适配这种联合类型的元数据解析。如果你的Swashbuckle版本低于6.5.0，它无法正确识别Results<T>中包含的多个响应类型，只会默认展示成功状态码（比如200 OK）。

解决步骤 #

1. 升级Swashbuckle.AspNetCore相关包
   打开项目的NuGet包管理器，将以下包全部升级到6.5.0或更高版本（建议选择与ASP.NET Core 8兼容的最新稳定版）：

   • Swashbuckle.AspNetCore
   • Swashbuckle.AspNetCore.Swagger
   • Swashbuckle.AspNetCore.SwaggerUI

2. 验证框架元数据是否正常生成
   可以通过简单的调试代码确认框架已经自动添加了响应元数据（仅用于验证，上线前移除）：

   // 在Program.cs的app.Run()前添加
   var endpointProvider = app.Services.GetRequiredService<IActionDescriptorCollectionProvider>();
   var targetAction = endpointProvider.ActionDescriptors.Items
       .FirstOrDefault(ad => ad.RouteValues["action"] == "GetById");
   if (targetAction != null)
   {
       var responseMetadata = targetAction.EndpointMetadata
           .OfType<ProducesResponseTypeMetadata>();
       // 输出查看是否包含200和404的元数据
       foreach (var meta in responseMetadata)
       {
           Console.WriteLine($"状态码：{meta.StatusCode}，类型：{meta.Type?.Name}");
       }
   }
   

   如果控制台输出包含200和404的元数据，说明框架工作正常，升级Swashbuckle后Swagger UI就能正确展示所有响应。

3. 无需手动添加[ProducesResponseType]
   升级完成后，框架自动生成的元数据会被Swashbuckle正确读取，完全符合文档中“无需添加特性”的描述，不需要额外手动添加[ProducesResponseType]。

额外排查点 #

如果升级后问题依旧，检查项目中是否有自定义的Swagger过滤器（比如实现IDocumentFilter或IOperationFilter的类），这类自定义逻辑可能会覆盖框架自动生成的响应元数据，导致Swagger UI无法正确展示所有状态码。

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