Swagger3.0 官方已经有了自己的 Spring Boot Starter,只需要添加一个 jar 包即可(SpringBoot 版本 2.3.6.RELEASE,低版本的SpringBoot要处理很多兼容性的问题)。。
<dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-spring-boot-starter</artifactId> <version>3.0.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency>
需要引用这2个包,springfox-boot-starter就是Swagger的Starter,knife4j-spring-boot-starter是Swagger-Bootstrap-UI的最新版本
Swagger-Bootstrap-UI的中文文档地址:https://doc.xiaominfo.com/ 开源地址:https://github.com/xiaoymin/Swagger-Bootstrap-UI
Swagger的注解和配置都是旧版本保持一致。
配置完之后,启动项目,访问地址:http://ip:port/doc.html
相关文档:https://mp.weixin.qq.com/s/-yTe0N5mwN2JJyPg-MOSVQ
https://mp.weixin.qq.com/s/Su33QhBRKnzwuNgTdriaTA
注意:以上两个Starter包中引用的swagger-model、swagger-core、swagger-annotations 的版本是1.5.20和1.5.22版本,在访问页面时,还会出现空字段报错的问题。建议手动在maven中剔除,更新1.6.1以上版本的jar包。