如何更新 NestJS Swagger 模块但使用 OpenAPI 2.0(Swagger)？答案

【问题标题】：How to update NestJS Swagger module but use OpenAPI 2.0(Swagger)?如何更新 NestJS Swagger 模块但使用 OpenAPI 2.0(Swagger)？
【发布时间】：2020-05-22 18:06:01
【问题描述】：

我们正在使用 NestJS 框架在 Node.js/Typescript 中制作 API。我们使用@nestjs/swagger 包使其符合OpenAPI（以前称为Swagger）。它旨在与Azure/autorest 一起使用以生成客户端代码。

Autorest 支持 OpenAPI 2.0 而不是 3.0。 @nestjs/swagger 3.*.* 实现了 OpenAPI 2.0。当我们将 @nestjs/swagger 更新为 4.*.* 时，它变成了 OpenAPI 3.0。这不符合我们的需求，因为我们不能再使用 Autorest。另一方面，不更新包意味着我们可能会错过安全更新，甚至无法更新整个 NestJS 框架。

有什么方法可以更新@nestjs/swagger 并继续使用 OpenAPI 2.0？

【问题讨论】：

标签： javascript node.js nestjs openapi

【解决方案1】：

很遗憾，没有。在内部，@nestjs/swagger v4 专门生成OpenAPI 3.0 specification。在您等待autorest 3 正式发布期间，目前有两种选择。

继续使用@nestjs/swagger v3。至于update the entire NestJS framework，你不用担心这个，因为 @nestjs/swagger 是一个非常独立的包。安全关于依赖项的问题，我可以看到您的担忧在那里有效。
试试autorest 3.beta 看看它是否足够稳定使用。

【讨论】：