SpringBoot中配置Swagger

首先在pom.xml添加springfox-swagger2和springfox-swagger-ui两个依赖，并且spring-boot-starter-parent的版本不能太高，可以设置为2.1.6.RELEASE

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
	<version>2.9.2</version>
</dependency>
 
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-ui</artifactId>
	<version>2.9.2</version>
</dependency>

在config/目录下创建一个SwaggerConfig.java。

package com.example.springdemo.config;
 
import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
 
@Configuration
@EnableSwagger2
public class SwaggerConfig {
}

如果@EnableSwagger2注解无法识别的话，需要点击这个循环图标重新加载maven project即可

在application.properties中添加下面代码，否则运行时会报空指针错误

spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER

运行项目，访问 http://localhost:8080/swagger-ui.html 即可看到Swagger界面

如果在maven中添加依赖

<!-- 引入swagger-bootstrap-ui包 /doc.html-->
<dependency>
	<groupId>com.github.xiaoymin</groupId>
	<artifactId>swagger-bootstrap-ui</artifactId>
	<version>1.9.1</version>
</dependency>

访问 http://localhost:8080/doc.html 则会使用另一种蓝色的UI打开界面