运行环境：
jdk 1.8
springboot 2.7.9
swagger 3.0.0
Maven引入：
<!-- swagger接口文档 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>application.yaml：
spring:
mvc:
pathmatch:
# 引入swagger3.0时加入的配置 localhost:2365/swagger-ui/index.html
matching-strategy: ant_path_matcherSwagger配置文件：
package com.ls.config.swaggerConfig;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
@Configuration
public class RosSwaggerConfig {
@Bean
public Docket createRestApi(){
//Docket: 摘要对象，通过对象配置 描述文件的信息
Docket docket = new Docket(DocumentationType.OAS_30);
docket.apiInfo(myApiInfo())
//select()：返回ApiSelectorBuilder对象，通过对象调用build()可以创建Docket对象
.select()
// 指定要扫描/维护接口文档的包（否则就全部扫描）
.apis(RequestHandlerSelectors.basePackage("com.ls.api.leakageApi"))
// 路径过滤：该Docket-UI展示时，只展示指定路径下的接口文档(any表示都展示)
.paths(PathSelectors.any())
.build();
return docket;
}
// 接口文档的概要信息，返回ApiInfo对象
private ApiInfo myApiInfo(){
//标题
String title = "ROS系统接口文档";
//简单描述
String description = "一个简单明了的接口信息文档";
//版本
String version = "V1.0.0";
// url接口路径前缀
String termsOfServiceUrl = "/";
//作者信息
Contact contact = new Contact("SLIU","","1549865882@qq.com");
//协议
String license = "The Apache License";
//协议url
String licenseUrl = "https://wwww.baidu.com";
ApiInfo apiInfo = new ApiInfoBuilder()
.title(title)
.description(description)
.version(version)
.termsOfServiceUrl(termsOfServiceUrl)
.contact(contact)
.license(license)
.licenseUrl(licenseUrl)
.build();
return apiInfo;
}
}
效果图：
引入Swagger遇到的困难：
描述：Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException 没有这个bean，空指针了。
[17:37:45.470] ERROR org.springframework.boot.SpringApplication 821 reportFailure - Application run failed org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:181) ~[spring-context-5.3.25.jar:5.3.25]
at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54) ~[spring-context-5.3.25.jar:5.3.25]
源码原因：
据网上资料找，3.0的Swagger已经不继承WebMvcConfig这个类，是继承了WebMvcConfigSupport类，从而改动了配置路径规则，然后报空指针，大概是这么个意思，想了解的可以去查一下具体原因。
解决报错的方法：
引入下面的配置，该配置是修改springboot的路径配置规则，springboot路径配置规则有两个，
path_pattern_parser ， ant_path_matcher 。我们需要修改成 ant_path_matcher 路径配置规则。
spring:
mvc:
pathmatch:
# 引入swagger3.0时加入的配置 localhost:2365/swagger-ui/index.html
matching-strategy: ant_path_matcher补充几点：
1. springfox-boot-starter 3.0.0 版本的swagger是最新版
2. 该版本已经不需要注解在启动文件上，例如：EnableOpenApi,EnableSwagger2等文章来源：https://www.toymoban.com/news/detail-459101.html
3.该最新版本的官网资料：Swagger官网资料文章来源地址https://www.toymoban.com/news/detail-459101.html
到了这里，关于spring boot 2.7.9 整合 Swagger 3.0的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
