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

Question

我[SwaggerOperation(Tags = new[] { "GroupA" })]用来在 Swagger UI 的控制器中对我的操作进行分组。

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

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

我无法在发行说明中找到有关此行为的重大更改的提示。

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

标签： swaggerswagger-uiswashbuckleswagger-codegen

Answer 1

所以所有这些都在发行说明中有很好的记录，你在阅读它时不应该着急。

我在我的问题中没有提到的是我需要安装Swashbuckle.AspNetCore.Annotations才能[SwaggerOperation]回来（它已经分开了）。

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

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

从发行说明：

注释更新：要继续使用特定于 swagger 的注释，您需要显式安装并启用新的 Swashbuckle.AspNetCore.Annotations 包，如此处所述。

“这里”将您准确带到描述此步骤的位置：

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