【问题标题】:Group controllers in same tag swagger在同一个标​​签中大摇大摆地分组控制器
【发布时间】:2026-01-20 21:20:09
【问题描述】:

我有 2 个具有不同 api 版本但相同的 swagger 标签的控制器

@RequestMapping("/v1")
@Tag(name = "controller")
public class ControllerV1 {
    v1 GET/POST/PUT
}
@RequestMapping("/v2")
@Tag(name = "controller")
public class ControllerV2 {
    v2 GET/POST/PUT
}

有没有办法在一个标签中按控制器对端点进行分组,但在每个控制器中保留 http 方法的顺序?

我想要类似的东西:

  • v1 获取
  • v1 放置
  • v2 获取
  • v2 放置

【问题讨论】:

    标签: java spring-boot spring-mvc swagger


    【解决方案1】:

    你可以做的是让版本号成为标签的一部分,比如@Tag("v1/controller") 这将实现一个很好的分组。

    【讨论】: