Springboot3集成Swagger(Springdoc)

我的bug呢

于 2024-05-06 23:26:06 发布

阅读量302

点赞数 8

文章标签： java springboot ui mvc

本文链接：https://blog.csdn.net/qq_43534244/article/details/138511539

版权

前言

根据网上Springboot集成Swagger3或者Swagger2教程基本上基于Springboot2，Springboot版本切换成3则会出现/swagger-ui/index.html 404，因此花费大量时间精力解决swagger 404（不起作用），而网上的各种404教程也只是基于Springboot2
实际上Springboot3仅支持OpenAPI规范，不再支持Swagger规范,更准确地说是Springboot3集成Springdoc

Springboot3整合Springdoc

依赖

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.0.0</version>
        </dependency>
        <!--Swagger-UI API文档生产工具-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
            <exclusions>
                <exclusion>
                    <artifactId>slf4j-api</artifactId>
                    <groupId>org.slf4j</groupId>
                </exclusion>
            </exclusions>
        </dependency>


        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>4.0.1</version>
        </dependency>
<!--        <dependency>-->
<!--            <groupId>com.github.xiaoymin</groupId>-->
<!--            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>-->
<!--            <version>4.4.0</version>-->
<!--        </dependency>-->

        <!-- https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-webmvc-ui -->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.3.0</version>
        </dependency>

    </dependencies>

application.yml

springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs
  group-configs:
    - group: 'default'
      paths-to-match: '/**'
      packages-to-scan: com.cll.controller

访问地址(这里设置了server.servlet.context-path=/jtool)

SpringDoc
在这里插入图片描述