在 net 5 web api 中升级 Swashbuckle 后如何使用 Swagger Response？

Question

我们有一个 Web API，其中包含约 150 个控制器（约 500 个方法），我们将其从 Core2.2 升级到 net5.0，同时我们还升级了 Swashbuckle 包。

Swashbuckle 的旧版本使用 SwaggerResponse 属性在 SwaggerUI 上显示信息，我们在 ~500 种方法中大量使用它。

在某些时候 SwaggerResponse 属性已被弃用，推荐的解决方案是另一种方法： https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/159

有没有办法

• 要么在最新的 Swashbuckle 中使用 SwaggerResponse 属性，要么
• 转换现有代码？

Answer 1

建议您使用ProduceResponseTypeAttribute, However you can still use SwaggerResponse via the NuGet package Swashbuckle.AspNetCore.Annotations。

类型 SwaggerResponse 并未完全删除，它只是从主要的 Swashbuckle 包即 Swashbuckle.AspNetCore 移至可选的额外包 Swashbuckle.AspNetCore.注解