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

Question

我们正在使用 NestJS 框架在 Node.js/Typescript 中制作 API。 我们使用@nestjs/swagger包使其符合OpenAPI（以前称为Swagger）。 它旨在与Azure/autorest 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看看它是否足够稳定以供您使用。