swagger - 更新到 Swashbuckle.AspNetCore 3.0 不再按标签分组

Question

我正在使用 [SwaggerOperation(Tags = new[] { "GroupA"})] 在 Swagger UI 的 Controller 中对我的操作进行分组。

更新到 3.0 后，不再考虑这一点，仅按 Controller 名称分组。

属性中的“已更改”标签名称也不再生成到 Swagger JSON/YAML 中，只有 Controller 名称作为标签。

我无法在 release notes 中找到提示关于此行为的重大更改。

任何关于行为改变和/或我如何恢复它的见解都将不胜感激。

Answer 1

所以所有这些都在发行说明中有详细记录，您在阅读它时不应该着急。

我在问题中没有提到的是，我需要安装 Swashbuckle.AspNetCore.Annotations 才能恢复 [SwaggerOperation](它已被分离)。

现在需要通过以下方式主动启用这些:

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

来自发行说明:

Updates to annotations: To continue using the swagger-specific annotations, you'll need to explicitly install and enable the new Swashbuckle.AspNetCore.Annotations package as described here.

“此处”将您带到描述此步骤的位置:

https://github.com/domaindrivendev/Swashbuckle.AspNetCore#swashbuckleaspnetcoreannotations