swagger - 渲染 Swagger OpenAPI v3 UI + Springboot 项目的问题

Question

我收到错误消息 - “请指明有效的 Swagger 或 OpenAPI 版本字段。支持的版本字段是 swagger：“2.0”和与 openapi:3.0.n 匹配的那些（例如，openapi:3.0.0）。 “当我粘贴时从 /api-docs 到 editor.swagger.io 生成的 json。 我有一些观察。

1. localhost:8080/v3/api-docs/yield - "{\"openapi\":\"3.0.1\", "\info\":{ ---------------- 这个 json 在 editor.swagger.io 中给出了提到的错误。

2. 在手动删除初始双引号和转义字符时，即 {"openapi":"3.0.1", "info":{ ----------------错误消失，即 UI 呈现没有任何问题。

3. 我的项目springboot版本是2.2.13.RELEASE，springdoc-openapi-ui版本是1.5.8，jackson-databind版本是2.10.5.1

4. OpenAPI 配置类 -

@Configuration
public class Config1 {
@Bean
public GroupedOpenApi publicApi() {
    return GroupedOpenApi.builder()
            .group("user")
            .pathsToMatch("/v1/**")
            .build();
}

@Bean
public OpenAPI customOpenAPI() {
    return new OpenAPI()
        .info(new Info().title("title1").description("test").version("1.0.0"));
}

如果我需要任何进一步的信息，请告诉我。有关该问题的任何意见都会有所帮助。谢谢你。

Answer 1

你可以 .version("v0.0.1")在你的customOpenAPI或publicApi像这样使用

@Bean
  public OpenAPI springShopOpenAPI() {
      return new OpenAPI()
              .version("v0.0.1"));
  }

有关更多详细信息，请参阅文档https://springdoc.org/#migrating-from-springfox