解决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 相关文章推荐
Java如何实现树的同构?
Jun 22 Java/Android
简单总结SpringMVC拦截器的使用方法
Jun 28 Java/Android
springboot项目以jar包运行的操作方法
Jun 30 Java/Android
Java生成读取条形码和二维码的简单示例
Jul 09 Java/Android
mybatis3中@SelectProvider传递参数方式
Aug 04 Java/Android
Java详细解析==和equals的区别
Apr 07 Java/Android
详解Spring Bean的配置方式与实例化
Jun 10 Java/Android
Spring Cloud OAuth2实现自定义token返回格式
Jun 25 Java/Android
SpringBoot项目部署到阿里云服务器的实现步骤
Jun 28 Java/Android
Java实现字符串转为驼峰格式的方法详解
Jul 07 Java/Android
一文了解Java动态代理的原理及实现
Jul 07 Java/Android
IDEA中sout快捷键无效问题的解决方法
Jul 23 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/02/28 PHP
PHP验证信用卡卡号是否正确函数
2015/05/27 PHP
HTML中嵌入PHP的简单方法
2016/02/16 PHP
PHP自定义函数实现格式化秒的方法
2016/09/14 PHP
分享8个Laravel模型时间戳使用技巧小结
2020/02/12 PHP
Some tips of wmi scripting in jscript (1)
2007/04/03 Javascript
js几个验证函数代码
2010/03/25 Javascript
jQuery ajax(复习)—Baidu ajax request分离版
2013/01/24 Javascript
基于JavaScript 数据类型之Boolean类型分析介绍
2013/04/19 Javascript
jquery获取子节点和父节点的示例代码
2013/09/10 Javascript
在线一元二次方程计算器实例(方程计算器在线计算)
2013/12/22 Javascript
jquery实现TAB选项卡鼠标经过带延迟效果的方法
2015/07/27 Javascript
[原创]Javascript 实现广告后加载 可加载百度谷歌联盟广告
2016/05/11 Javascript
Vuejs第十三篇之组件——杂项
2016/09/09 Javascript
Angular2从搭建环境到开发步骤详解
2016/10/17 Javascript
一种angular的方法级的缓存注解(装饰器)
2018/03/13 Javascript
一百行JS代码实现一个校验工具
2019/04/30 Javascript
微信小程序用户拒绝授权的处理方法详解
2019/09/20 Javascript
详解JavaScript数据类型和判断方法
2020/09/04 Javascript
[00:43]2016完美“圣”典风云人物:单车宣传片
2016/12/02 DOTA
[00:09]DOTA2全国高校联赛 精彩活动引爆全场
2018/05/30 DOTA
pycharm使用matplotlib.pyplot不显示图形的解决方法
2018/10/28 Python
Python上下文管理器用法及实例解析
2019/11/11 Python
python NumPy ndarray二维数组 按照行列求平均实例
2019/11/26 Python
python3中rank函数的用法
2019/11/27 Python
Pycharm pyuic5实现将ui文件转为py文件,让UI界面成功显示
2020/04/08 Python
opencv python 图片读取与显示图片窗口未响应问题的解决
2020/04/24 Python
浅谈html5 video 移动端填坑记
2018/01/15 HTML / CSS
意大利宠物用品购物网站:Bauzaar
2018/09/15 全球购物
美国波西米亚风格精品店:South Moon Under
2019/10/26 全球购物
学校安全教育制度
2014/01/31 职场文书
岗位职责风险防控
2014/02/18 职场文书
2015年收银员个人工作总结
2015/04/01 职场文书
小孩不笨观后感
2015/06/03 职场文书
如何理解Vue前后端数据交互与显示
2021/05/10 Vue.js
Appium中scroll和drag_and_drop根据元素位置滑动
2022/02/15 Python