SpringMVC集成Swagger2，初尝试和遇到的相关问题

最新推荐文章于 2024-07-04 09:05:13 发布

MikeLC7

最新推荐文章于 2024-07-04 09:05:13 发布

阅读量4.4k

点赞数

分类专栏： Spring 文章标签： SpringMVC Swagger2 使用

本文链接：https://blog.csdn.net/MikeLC7/article/details/75088123

版权

本文档记录了SpringMVC项目中集成Swagger2的过程和遇到的挑战。首先介绍了为何从手动编写Word文档转向使用Swagger，然后详细说明了集成步骤，包括添加依赖、配置Spring以及设置URL映射。特别强调了Spring的url-pattern必须设为/，以避免Swagger资源加载失败。由于作者尚未深度使用Swagger，目前的记录较为基础，后续将随着实践深入进行更新。

摘要由CSDN通过智能技术生成

前言

之前项目的接口文档都是手动编写Word文档来做，制作成本较高，并且在进行版本迭代的时候进行标注和说明不是很方便，后来发现Swagger之后进行了简单的操作。
截止目前还未深度使用，本文仅记录初次使用Swagger的过程和遇到的问题，后续进行补充。
前言：
当前项目使用SpringMVC，集成Swagger2

配置

Step1：添加依赖包

    <!--springfox 相关依赖 start-->
    <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.6.1</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version&g