springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容

springdoc-openapi-ui not compatible with openapi-generator-maven-plugin

我从 openapi 规范 (3.0.1) 开始设计并使用 openapi-generator-maven-plugin (5.1.0) 生成代码,然后我使用 springdoc-openapi-ui 用于 spring 启动 (2.5.4)。

我需要手动将生成代码中的大部分注释从 io.swagger.annotations.* 迁移到 io.swagger.v3.oas.annotations.*,如此处所述 https://springdoc.org/#migrating-from-springfox

我想在不手动迁移的情况下生成代码,但还无法找到要使用哪个生成器与 springdoc-openapi-ui.

兼容

目前不支持 V3 注释。您可以通过覆盖小胡子模板来做到这一点。

或者等待 5.3.1 发布并进行以下更改:

https://github.com/OpenAPITools/openapi-generator/pull/9775