文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Spring集成Swagger常见错误及解决办法

2024-04-02 19:55

关注

概览

在当下几乎所有的公司都采用了前后端分离的开发模式,Swagger作为了在API在线文档工具,几乎是后端开发的必备组件,最近公司的有个项目,在项目启动和打开Swagger页面时候,后端产生了大量的异常日志,虽然不影响现在的正常启动,不过,每次看到大量的异常日志,对于有代码洁癖的我,不能忍。于是乎今天抽了个时间把以下这些问题解决了,解决后再看日志,简直不能再爽歪歪啦~ 下面对问题以及解决的办法做个记录。

问题一

异常描述:No enum constant org.springframework.web.bind.annotation.RequestMethod.Get

项目启动的时候,后台日志报如下异常:

原因

根据异常栈,能看出是springfox-swagger-common执行OperationHttpMethodReader.apply()方法是抛出来的,分析日志 RequestMethod.Get 没有对应的enum,通过检查Controller中RequestMethod,发现了问题所在:

枚举类中method方法都是大写, 而我的代码中将method写成了:

导致了在获取enum类型的时候,匹配不上抛出异常。

解决办法

将httpMethod = "Get" 给成 "GET"即可。其实原来就很好奇为什么httpMethod后添加的方法名称是大写,当时也没有深入的去研究,正好借此机会知道背后的原因,这样在开发过程中才能避免很多坑~~

问题二

异常描述:java.lang.NumberFormatException:For input string:""

项目起来后,访问swagger-ui.html页面后,接口文档可以正常展示和使用,不过后台会出现异常的日志:

原因

看日志,swagger-models这个包中的AbstractSerializableParameter.getExample()方法的时候出现异常了,此外还有一条WARN日志,Illegal DefaultValue null for parameter type integer,意思是:有个默认值是空字符串的变量转换成Integer类型时异常。

通过全局检索:Illegal DefaultValue,查看如下:

发现example只判断的null这种情况,当example如果为空字符串的话,照样往下执行,Long.valueOf(example)就是抛出异常,奔溃的心,好想把他的源码改掉呀~

解决办法

分析了下maven的包依赖:

发现swagger-models的版本为 1.5.20,果断去mvnrepository上去寻找有么有新的包修复过这个bug:

发现最新的版本 1.6.2,果断换成最新版本:


<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-models</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 解决 Illegal DefaultValue null for parameter type integer -->
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.6.2</version>
</dependency>

看下源码:

发现这个bug已经修复啦,哈哈哈哈

以上就是Spring集成Swagger常见错误及解决办法的详细内容,更多关于Spring集成Swagger常见错误的资料请关注编程网其它相关文章!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯