OpenAPI2向OpenAPI3的升级简单指引如下：

1. 将 Swagger 2 注解替换为 Swagger 3 注解

• 它已经包含在依赖: springdoc-openapi-starter-webmvc-ui中 .包路径是: io.swagger.v3.oas.annotations.
• 相对常用的替换对照如下:

2. 创建ApiDocs实例

• 分组API Docs实例

升级前: Swagger2

  @Bean
  public Docket api1() {
      return new Docket(DocumentationType.SWAGGER_2)
              .select()
              .apis(RequestHandlerSelectors.basePackage("com.xx.xxx"))
              .paths(PathSelectors.regex("/api1.*"))
              .build()
              .groupName("Group Api1")
              .apiInfo(apiInfo());
  }

  @Bean
  public Docket api2() {
       return new Docket(DocumentationType.SWAGGER_2)
              .select()
              .apis(RequestHandlerSelectors.basePackage("com.xx.xxx"))
              .paths(PathSelectors.regex("/api2.*"))
              .build()
              .groupName("Group Api2")
              .apiInfo(apiInfo());
  }

升级后: Swagger3

  @Bean
  public GroupedOpenApi api1() {
      return GroupedOpenApi.builder()
              .group("Group Api1")
              .pathsToMatch("/api1/**")
              .build();
  }
  @Bean
  public GroupedOpenApi api2() {
      return GroupedOpenApi.builder()
              .group("Group Api2")
              .pathsToMatch("/api2/**")
              .addOpenApiMethodFilter(method -> method.isAnnotationPresent(CustomApi.class))
              .build();
  }

• 单个API Docs实例

单个实例时，可以直接使用配置文件结合单一实例Bean,示例如下:

springdoc.packagesToScan=com.xx.xxx, com.xx.yyy
springdoc.pathsToMatch=/api1, /api/custom/**

  @Bean
  public OpenAPI singleApi() {
      return new OpenAPI()
              .info(new Info().title("Single API")
              .description("Single API sample application")
              .version("v1.0.0")
              .license(new License().name("MIT").url("http://com.xx.xxx")))
              .externalDocs(new ExternalDocumentation()
              .description("External Wiki Documentation")
              .url("https://com.xx.xxx/docs"));
  }

Tags：apiimplicitparams注解用法