springboot2.6.4如何集成swagger3.0,解決遇到的一些問題

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配置文件的配置也不同，所以請大家多多注意。