springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容
Posted
技术标签:
【中文标题】springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容【英文标题】:springdoc-openapi-ui not compatible with openapi-generator-maven-plugin 【发布时间】:2021-11-09 05:11:32 【问题描述】:我开始使用 openapi 规范 (3.0.1) 设计并使用 openapi-generator-maven-plugin (5.1.0) 生成代码,然后我使用 springdoc-openapi-ui 进行 spring boot (2.5.4 )。
我需要手动将生成代码中的大部分注释从 io.swagger.annotations.* 迁移到 io.swagger.v3.oas.annotations.* ,如此处所述https://springdoc.org/#migrating-from-springfox
我想在不手动迁移的情况下生成代码,但目前还没有找到与 springdoc-openapi-ui 兼容的生成器。
【问题讨论】:
【参考方案1】:目前不支持 V3 注释。您可以通过覆盖 mustache 模板来做到这一点。
或者只是等待 5.3.1 版本进行以下更改:
https://github.com/OpenAPITools/openapi-generator/pull/9775
【讨论】:
以上是关于springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容的主要内容,如果未能解决你的问题,请参考以下文章
springdoc-openapi-ui + swagger 不理解 @PathVariable required = false 标志
使用 Spring Security 启用 Swagger springdoc-openapi-ui (OpenAPI 3.0) - 无法访问 swagger-ui.html (401)