问题描述
我们正在尝试将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(您的路径)