Swagger简介

• 号称：世界上最流行的API框架
• PestFul API文档在线自动生成器 --> API文档与API定义同步更新
• 可以直接运行，测试API接口 支持多种语言

强调：我的springboot版本2.6.4，swagger为3.0，其他版本可能修改不成功，大家可以试试。

在集成的时候出现了很多问题

坑一：首先先排除问题 ，我使用的springboot版本2.6.4，导入的swagger依赖如下

<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-boot-starter</artifactId>
   <version>3.0.0</version>
</dependency>

坑二：springboot的配置文件（yml或者properties）中添加如下配置

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

坑三：在自己创建的swagger类上加入注解，@Configuration与@EnableOpenApi，注意区分注解，和swagger2的不一样。

@Configuration
@EnableOpenApi
public class SwaggerConfig {
}

坑四： 然后访问路径,访问路径也有变化,不在是之前的 swagger-ui.html --> swagger-ui/index.html

http://localhost/swagger-ui/index.html

当然我的在yml配置文件加了80端口号，完成上述配置即可解决。

server:
  port: 80

总结:

在网上查阅资料时发现网上的学习视频有的用的swagger2，和swagger3的配置有很大的不一样，pom依赖不同、注解不同、yml配置文件的配置也不同，所以请大家多多注意。