访问Swagger：java.lang.NumberFormatException: For input string: ""

场景

启动项目，接着访问Swagger

依赖版本如下：1.5.20

查看控制台输出：报错如下

排查

1. 首先看报错：For input string: ""：这个错误表明程序尝试将一个空字符串（""）转换成数值类型（如 int 或 double），但由于空字符串没有有效的数字表示形式，导致转换失败

2. 由于不是我们编写的代码，看到报错也有一种无力感，我们进到源码里面定位问题，按住ctrl+左键进入AbstractSerializableParameter这个类，定位到getExample方法

   

3. 打上断点，接着浏览器刷新一下进入断点

   可以看到，AbstractSerializableParameter.java是swagger-models-1.5.20.jar包下面的一个类

   

   在对应的位置打上断点

   

4. 断点调试

   

原因是在该swagger版本下对于数字类型的字段没有设置example值,导致swagger处理时类型转换异常,算是swagger-models1.5.20的一个小bug

解决

第一种解决方案

手动添加example值

• 通过断点调试已经看出了问题，就是example这个字段为空字符串所导致的，那么修改起来也是非常的简单，加上对应的example 属性就好了

  

这种方式的弊端：费时费力

• 假设你此时已经写好了项目所有的接口，如果有100个地方需要修改，只能一个一个去修改

第二种解决方案

导入1.5.21(及之后)版本的swagger-models（推荐）

• 来，看下依赖

• 可以看到swagger-models:1.5.20在swagger-spring-boot-starter下面，排除掉这个依赖

• 排除了之后，单独引入swagger-models:1.5.21

这种方式的好处：不需要修改任何一处代码，只需要更改依赖就行。

测试

• 刷新下maven，重新访问下测试，观察控制台输出

总结

总结来说就是1.5.20这个版本下对于数字类型的字段如果没有设置example值会导致swagger处理时类型转换异常,  建议使用第二种方案~升级版本即可