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

Question

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

我们正在使用Springboot应用程序。

按照spring文档，我按照以下步骤进行升级

http://springfox.github.io/springfox/docs/current/

"2.1.3.从现有2.x版本迁移“

Spring引导应用程序

1.删除早期版本的库包含。特别是移除跳狐2和跳狐-傲慢-ui包含。

2.删除@EnableSwagger2 2注释

3.加入跳狐启动程序。

4.Springfox 3.x消除了对番石榴和其他第三方库的依赖(还不是零dep！如果您使用番石榴谓词/函数，则需要转换到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文档仍然过时，3.0方面的覆盖率也很差。

我想知道有谁有同样的问题吗？

Answer 1

在您的情况下尝试使用/v3/api-docs或/api/v3/api-docs。

Answer 2

那不起作用。根据SpringFox文档：“/ v2 /API是SpringFox用于文档的缺省值。v2不引用您的API文档版本(可以在文档配置中更改)，而是使用Swagger规范的版本.”

springfox.documentation.swagger.v2.path=/my/docs (你的道路)