解决Swagger2返回map复杂结构不能解析的问题


Posted in Java/Android onJuly 02, 2021

今天有同事用swagger2开发时,有一方法返回Map<String,List<Object>>出现无法解析错误。

Pom.xml引入的swagger版本如下:

<!--swagger start-->
        <dependency>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-annotations</artifactId>
            <version>1.5.20</version>
        </dependency>
        <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>2.6.1</version>
        </dependency>
        <!--swagger end-->

具体原因:

swaggerconfig没有默认添加map的复杂结构引起的,需要手动添加。

步骤:

1. 找到swaggerconfig类,在Docket方法里添加一些mapRule即可

2. 这里设计rule比较灵活,我就按标题的格式添加,其中Model.class是自定义的业务类,换成自己的即可。

docket.alternateTypeRules(AlternateTypeRules.newMapRule(String.class, List.class));
docket.alternateTypeRules(AlternateTypeRules.newMapRule(List.class, Model.class));

具体代码如下:

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket createRestApi() {
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
 
        docket.alternateTypeRules(AlternateTypeRules.newMapRule(String.class, List.class));
        docket.alternateTypeRules(AlternateTypeRules.newMapRule(List.class, Model.class));
        return docket;
    }
}

Swagger使用过程中遇到的坑

1、无限请求

如果swagger页面请求有错误,swagger会无限尝试访问,后面重启项目的时候,控制层会无限刷新出现日志的内容

本地的好办,如果项目项目部署到服务器中,可能十几分钟产生几个G的日志文件

解决方式:最简单的方式——关闭请求报错的浏览器

2、同名问题

@Api(同名的问题) 因为swagger会根据tags 的名称查找对象,有同名对象的时候,swagger的文档就会出现问题

如果swagger的某个API下出现不属于该API的请求,这个就是API的同名的问题,查找相同的API名称替换即可

3、类上的注解“/”的问题

@ApiModel(不能使用“/”)

解决Swagger2返回map复杂结构不能解析的问题

Errors
Hide
Resolver error at paths./v1-0/Configuration/add.post.parameters.1.schema.properties.listHotCarBrandIVO.items.$ref
Could not resolve reference because of: Could not resolve pointer: /definitions/热门车/品牌/的IVO does not exist in document

4、使用map作为返回类型报错,

Errors
Hide
Resolver error at definitions.Map«string,List«卖车车辆信息OVO»».additionalProperties.$ref
Could not resolve reference because of: Could not resolve pointer: /definitions/List does not exist in document

两个解决方案:升级swagger版本号,这个是我用2.8.0报错会报错,网上有说升级版本可以解决,这个我没有去试,

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.8.0</version>
</dependency>

我这边的解决方案是,将map定义在对象中,面向对象编程,而且这样生成文档的时候,注释也会显示好

解决Swagger2返回map复杂结构不能解析的问题

5、swagger版本的问题,2.8之前的版本在 路径/{id} +@pathVarisble 这样的写法

2.8之前,swagger给出的类型居然是body,需要用json的格式传这个很奇怪,

版本更新到2.8以后,路径后面绑定的参数就是 swagger给出的类型居然是就能是param

适当的更新版本有好处

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.8.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.8.0</version>
</dependency>

6、没有重现过的一个bug

Failed to execute 'fetch' on 'Window': Failed to parse URL from http://localhost/8765undefindFailed to parse URL from http://localhost/8765undefind

我一直重启项目 swagger没有重现问题

后来我修改请求你方法上的api注释,重启就可以,可能是swagger上api冲突,关键是这个没有提示,好晕;如果谁找到重现这个问题来说一下

以上为个人经验,希望能给大家一个参考,也希望大家多多支持三水点靠木。

Java/Android 相关文章推荐
idea搭建可运行Servlet的Web项目
Jun 26 Java/Android
Spring Data JPA的Audit功能审计数据库的变更
Jun 26 Java/Android
每日六道java新手入门面试题,通往自由的道路
Jun 30 Java/Android
Spring Boot 排除某个类加载注入IOC的操作
Aug 02 Java/Android
Logback 使用TurboFilter实现日志级别等内容的动态修改操作
Aug 30 Java/Android
Java基于Dijkstra算法实现校园导游程序
Mar 17 Java/Android
InterProcessMutex实现zookeeper分布式锁原理
Mar 21 Java/Android
Spring事务管理下synchronized锁失效问题的解决方法
Mar 31 Java/Android
Android Flutter实现3D动画效果示例详解
Apr 07 Java/Android
Java 通过手写分布式雪花SnowFlake生成ID方法详解
Apr 07 Java/Android
springboot为异步任务规划自定义线程池的实现
Jun 14 Java/Android
maven 解包依赖项中的文件的解决方法
Jul 15 Java/Android
SpringBoot工程下使用OpenFeign的坑及解决
Jul 02 #Java/Android
SpringBoot读取Resource下文件的4种方法
Jul 02 #Java/Android
Java基础-封装和继承
Java 泛型详解(超详细的java泛型方法解析)
SpringBoot集成Druid连接池连接MySQL8.0.11
Java使用httpRequest+Jsoup爬取红蓝球号码
使用Springboot实现健身房管理系统
You might like
php查找字符串出现次数的方法
2014/12/01 PHP
PHP互换两个变量值的方法(不用第三变量)
2016/11/14 PHP
如何通过PHP实现Des加密算法代码实例
2020/05/09 PHP
基于Jquery的文字自动截取(提供源代码)
2011/08/09 Javascript
JavaScript数据类型详解
2015/04/01 Javascript
基于jQuery实现仿百度首页选项卡切换效果
2016/05/29 Javascript
js实现刷新页面后回到记录时滚动条的位置【两种方案可选】
2016/12/12 Javascript
利用Vue.js实现checkbox的全选反选效果
2017/01/18 Javascript
js实现PC端和移动端刮卡效果
2020/03/27 Javascript
元素全屏的设置与监听实例
2017/11/28 Javascript
解决iview打包时UglifyJs报错的问题
2018/03/07 Javascript
js实现自动播放匀速轮播图
2020/02/06 Javascript
python list使用示例 list中找连续的数字
2014/01/27 Python
使用python删除nginx缓存文件示例(python文件操作)
2014/03/26 Python
python获取android设备的GPS信息脚本分享
2015/03/06 Python
用Python实现web端用户登录和注册功能的教程
2015/04/30 Python
Django REST framework 分页的实现代码
2019/06/19 Python
Python中字典与恒等运算符的用法分析
2019/08/22 Python
在 Linux/Mac 下为Python函数添加超时时间的方法
2020/02/20 Python
python matplotlib实现将图例放在图外
2020/04/17 Python
Java爬虫技术框架之Heritrix框架详解
2020/07/22 Python
详解python安装matplotlib库三种失败情况
2020/07/28 Python
Python 获取异常(Exception)信息的几种方法
2020/12/29 Python
使用Python制作一盏 3D 花灯喜迎元宵佳节
2021/02/26 Python
纯CSS3代码实现文字描边
2016/04/25 HTML / CSS
凯特方迪化妆品官网:Kat Von D Beauty
2016/11/15 全球购物
伦敦的高级牛仔布专家:Trilogy
2018/08/06 全球购物
最畅销的视频游戏享受高达90%的折扣:CDKeys
2020/02/10 全球购物
北大青鸟学生求职信
2013/09/24 职场文书
生产部经理岗位职责
2013/12/16 职场文书
干部现实表现材料
2014/02/13 职场文书
政府门卫岗位职责
2014/04/29 职场文书
企业公益活动策划方案
2014/08/24 职场文书
MBA推荐信怎么写
2015/03/25 职场文书
质量承诺书格式范文
2015/04/28 职场文书
《鸡兔同笼》教学反思
2016/02/19 职场文书