SpringBoot 3.0.x使用SpringDoc

为什么使用SpringDoc

在Springfox3.0停更的两年里，SpringBoot进入3.0时代， SpringFox出现越来越多的问题，最为明显的就是解析器的问题，已经在上文 中解释清楚，这里就不再赘述。
SpringDoc是Spring官方推荐的API，相信不会轻易停更。

如何引入SpringDoc

SpringDoc有多个版本，如果你使用的是SpringBoot3.0，请确保SpringDoc的版本在2.0以上，本文使用的版本是2.0.2

implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'

如何配置

1.  
   package com.jiahetng.ztj.config;
2.  
    
3.  
   import io.swagger.v3.oas.models.ExternalDocumentation;
4.  
   import io.swagger.v3.oas.models.OpenAPI;
5.  
   import io.swagger.v3.oas.models.info.Info;
6.  
   import io.swagger.v3.oas.models.info.License;
7.  
   import org.springframework.context.annotation.Bean;
8.  
   import org.springframework.context.annotation.Configuration;
9.  
    
10.  
     
11.  
    @Configuration
12.  
    public class SwaggerConfig {
13.  
     
14.  
    @Bean
15.  
    public OpenAPI springShopOpenAPI() {
16.  
    return new OpenAPI()
17.  
    .info(new Info().title("****系统API")
18.  
    .description("****系统 Restfull API")
19.  
    .version("v0.0.1")
20.  
    .termsOfService("https://www.jianshu.com/u/c8c1e5ac61e0")
21.  
    .license(new License().name("****").url("https://www.jiahetng.com")))
22.  
    .externalDocs(new ExternalDocumentation()
23.  
    .description("**** Issues Documentation")
24.  
    .url("https://****"));
25.  
    }
26.  
    }

异常

发生异常

原因是：此版本的swagger前端无法正常解析带 “\” 格式的JSON报文

解决办法

临时去除Json设置，使用默认设置，就好，更好的优化将在下篇文章更新

这篇好文章是转载于：学新通技术网