Spring集成Swagger常见错误及解决办法
概览
在当下几乎所有的公司都采用了前后端分离的开发模式，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常见错误的资料请关注猪先飞其它相关文章！
相关文章
- 这篇文章主要介绍了Spring AOP 对象内部方法间的嵌套调用方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教...2021-08-29
Spring Cloud 中@FeignClient注解中的contextId属性详解
这篇文章主要介绍了Spring Cloud 中@FeignClient注解中的contextId属性详解，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教...2021-09-25Springboot如何实现Web系统License授权认证
这篇文章主要介绍了Springboot如何实现Web系统License授权认证,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-05-28- 这篇文章主要介绍了Swagger中@ApiIgnore注解的使用，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教...2021-10-21
如何在Spring WebFlux的任何地方获取Request对象
这篇文章主要介绍了如何在Spring WebFlux的任何地方获取Request对象，帮助大家更好的理解和使用springboot框架，感兴趣的朋友可以了解下...2021-01-26- 这篇文章主要介绍了详解SpringCloudGateway内存泄漏问题，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-07-16
- @Autowired 注解的主要功能就是完成自动注入,使用也非常简单,但这篇文章主要给大家介绍了关于Spring为什么不推荐使用@Autowired注解的相关资料,需要的朋友可以参考下...2021-11-03
Springboot如何使用mybatis实现拦截SQL分页
这篇文章主要介绍了Springboot使用mybatis实现拦截SQL分页,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-06-19- 这篇文章主要介绍了SpringMVC文件上传原理及实现过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-07-15
Spring Data JPA 关键字Exists的用法说明
这篇文章主要介绍了Spring Data JPA 关键字Exists的用法说明，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教...2021-06-10tomcat启动完成执行 某个方法 定时任务(Spring)操作
这篇文章主要介绍了tomcat启动完成执行 某个方法 定时任务(Spring)操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2020-09-25使用Maven 搭建 Spring MVC 本地部署Tomcat的详细教程
这篇文章主要介绍了使用Maven 搭建 Spring MVC 本地部署Tomcat,本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下...2021-08-16- 这篇文章主要介绍了Spring Cloud负载均衡及远程调用实现详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2021-09-18
- 这篇文章主要介绍了SpringMvc自动装箱及GET请求参数原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-09-19
- 这篇文章主要介绍了Springboot使用thymeleaf动态模板实现刷新,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-08-31
- 这篇文章主要介绍了SpringMvc获取请求头请求体消息过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-09-17
Idea打包springboot项目没有.original文件解决方案
这篇文章主要介绍了Idea打包springboot项目没有.original文件解决方案,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-07-26- 这篇文章主要介绍了spring boot 使用utf8mb4的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2021-02-20
Springmvc ResponseBody响应json数据实现过程
这篇文章主要介绍了Springmvc ResponseBody响应json数据实现过程,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-10-26- 这篇文章主要介绍了SpringData Repository接口用法解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-08-27