Autorest 错误 - swagger.json' 不是有效的 OpenAPI 2.0 定义（预期为 'swagger: 2.0'）答案

【问题标题】：Autorest error - swagger.json' is not a valid OpenAPI 2.0 definition (expected 'swagger: 2.0')Autorest 错误 - swagger.json' 不是有效的 OpenAPI 2.0 定义（预期为 'swagger: 2.0'）
【发布时间】：2020-04-23 00:10:16
【问题描述】：

我的 api 正在运行带有 Swashbuckle.AspNetCore 5.0.0-rc5 的 net core 3.0

当我在生成的 swagger.json 文件上运行 autorest 时，我得到：

swagger.json is not a valid OpenAPI 2.0 definition (expected 'swagger: 2.0')

我的 swagger.json 文件确实说“openapi”：“3.0.1”。它曾经是 v2.0，但自从我升级到 net core 3.0 后，我不得不升级 Swashbuckle，它现在使用 v3.0.1 创建 json 文件

我运行了“choco install autorest”，所以我应该运行最新版本

如果 autorest 不支持 openapi3.0，肯定还有办法生成 openapi2.0 json 文件？

【问题讨论】：

标签： swagger asp.net-core-webapi openapi autorest

【解决方案1】：

关注了这个帖子，auto rest 还不支持最新的 open api 但是有解决方法

https://github.com/Azure/autorest/issues/2680

你可以这样做：

app.UseSwagger(o => o.SerializeAsV2 = true);

【讨论】：

显然它现在确实支持 openapi 3 github.com/Azure/autorest/tree/…