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

Question

我们正在使用 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？

Answer 1

不幸的是没有。在内部，@nestjs/swagger v4 专门生成 OpenAPI 3.0 specification具体来说。当您等待autorest 3时，现在有两个选择待正式发布。

• 继续关注@nestjs/swagger v3。至于update the entire NestJS framework ，你不必担心这个，因为 @nestjs/swagger是一个几乎独立的包。安全 关于依赖关系的问题，我可以看到您的担忧是有道理的。
• 尝试 autorest 3.beta看看它是否足够稳定让你可以 使用。