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

Question

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

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

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

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

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

Answer 1

因此，所有这些都在发行说明中得到了详细记录，您在阅读时不应该着急。

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

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

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

从发行说明来看：

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

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