引入依赖

<dependency>
    <groupId>org.ssssssss</groupId>
    <artifactId>magic-api-plugin-swagger</artifactId>
    <version>magic-api-lastest-version</version>
</dependency>

提示

Swagger相关的依赖需要自行引入

配置

# 以下配置均可省略
magic-api:
    swagger:
        version: 1.0
        description: MagicAPI 接口信息
        title: MagicAPI Swagger Docs
        name: MagicAPI 接口
        location: /v2/api-docs/magic-api/swagger2.json

magic-api.location不能被拦截

使用

在启动类上加入注解@EnableSwagger2， 3版本用@EnableOpenApi注解

目前Swagger对于spring boot 2.6.0以上版本支持不够友好，需要加入配置：

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

访问UI页面，http://localhost:9999/swagger-ui.html

提示

swagger插件不支持Spring Boot 3.x版本，如果使用Srping Boot 3.x版本请使用 springdoc插件