使用springfox和Swagger2时，为什么v2 / api-docs是默认URL？

我刚开始按照这个指南开始使用招摇，但我发现了一些非常奇怪的东西对我来说毫无意义。

据我所知，当您拥有API版本号为2的文档时，应使用v2 / api-docs。

所以，默认应该只是api-docs，但由于一些奇怪的原因，我发现默认是v2 / api-docs。

检查库文档我发现了这个 。

如何在不能使用v2的情况下覆盖该值？ （当我的API将达到v2但我也想展示旧版文档）。

或许我使用v2的概念是错误的？ 有人可以帮我弄这个吗？

Answer 1

/v2/api-docs URL是SpringFox用于文档的默认URL。 v2没有引用API的文档版本（可以在Docket配置中更改），但是使用的是Swagger规范的版本。 请查看此处的文档以自定义Swagger文档URL。 简而言之，您需要修改环境属性以更改文档将显示在的URL：

 springfox.documentation.swagger.v2.path=/my/docs 

这会将SpringFox Swagger文档的默认URL从/v2/api-docs更改为您指定的任何内容。 要实现此function，请将以上属性添加到新的或现有的属性文件中，然后将其作为属性源添加到Springfox配置类中：

 @PropertySource("classpath:swagger.properties") @Configuration public class SwaggerConfig {...}