从SpringFox2.x升级到SpringFox3.0开放API

问题描述

我们正在尝试将SPringFox2.0升级到3.0 Open API规范。但是当我们使用''url生成开放文档时,它显示版本为2.0。不确定为什么版本仍指向旧版本。

我们正在使用Springboot应用程序

我按照以下步骤升级了Spring Fox文档

[http://springfox.github.io/springfox/docs/current/] [1]

“ 2.1.3。从现有的2.x版本迁移”

Spring Boot应用程序

1。删除早期版本中的库包含。专门删除springfox-swagger2和springfox-swagger-ui包含物。

2。删除@ EnableSwagger2批注

3。添加springfox-boot-starter

4.Springfox 3.x删除了对番石榴和其他第三方库的依赖(尚不为零)!取决于spring插件和开放的api库用于注释和模型),因此,如果您使用番石榴谓词/函数,则需要过渡Java 8功能接口

我按照上面的所有步骤操作,生成了“ http:// localhost:XXXX / api / v1 / api-docs?group = API_Version_1”,但版本显示为2.0 {“ swagger”:“ 2.0”,“ info”:{........

我也在SwaggerConfig中进行了修改:DocumentationType.SWAGGER_2到DocumentationType.OAS_30(没有提到文档,我想他们错过了它)

我相信仍然缺少一些东西,Spring Fox文档仍然过时,并且对3.0方面的覆盖不佳。

我想知道有人遇到同样的问题吗?

解决方法

尝试根据您的情况使用/v3/api-docs/api/v3/api-docs

,

那没有用。 根据Spring Fox文档: “ / v2 / api-docs URL是SpringFox用于文档编制的默认URL。v2并不引用您API的文档版本(可以在Docket配置中更改),而是所使用的Swagger规范的版本。 。”

springfox.documentation.swagger.v2.path = / my / docs(您的路径)