SpringMVC+Swagger2快速整合，以及遇到的各种问题解决方案

最新推荐文章于 2024-08-18 21:24:22 发布

原创最新推荐文章于 2024-08-18 21:24:22 发布 · 1.3k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#SpringMVC #Swagger #接口测试 #服务接口

集成框架专栏收录该内容

18 篇文章

订阅专栏

本文介绍如何使用Swagger简化服务平台的接口管理，提升开发效率。详细解释了项目快速整合Swagger的方法，包括配置步骤与常见问题解决方案，如接口不显示和数据返回空等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

通过Swagger来管理服务平台对外提供的接口，方便开发测试，对于后台开发中节约与客户端开发者的交流成本，避免通过修改复杂的文档完成接口对接，使得项目开发更具有简洁性、高效性。

项目快速整合Swagger

实现方案：点击查看
https://github.com/YouAreOnlyOne/FastFrameJar/tree/master/ApiConfig

最终效果
在这里插入图片描述

相关问题
1、配置运行正常，接口不显示
No operations defined in spec!
SpringMVC+Swagger2 发现能出现swagger-ui.html页面，但是无法显示接口方法。
swagger-ui不显示接口列表。
解决方法：
1）不要把配置文件放在controller目录下，
2）在springmvc配置文件中添加过滤和扫描

	<mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/" />
    <mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />
    <bean id="testSwagger" class="com.construct.test.TestSwaggerApi"></bean>

2、尝试访问http://localhost:8080/v2/api-docs，得到的数据为{}
查资料得知fastjson版本问题，替换即可:

<dependency>

<groupId>com.alibaba</groupId>

<artifactId>fastjson</artifactId>

<version>1.1.41</version>

</dependency>

替换为：

<dependency>

<groupId>com.alibaba</groupId>

<artifactId>fastjson</artifactId>

<version>1.2.28</version>

</dependency>