【异常处理】关于访问swagger-ui报错java.lang.NumberFormatException: For input string: ““的解决方案总结

墨蓝 2022-11-18 02:25 223阅读 0赞

**本文目录**

一、背景描述

二、问题原因

2.1 为什么会报错？

2.2 问题排查

2.3 哪种情况会报这样的错？

2.4 为什么上述情况会报错？

三、解决方案

3.1 第一种解决方案

3.2 第二种解决方案

--------------------

# 一、背景描述 #

最近新创建了一个Spring boot项目，接口写完之后，通过Swagger-ui访问调试接口，在浏览器中输入http://localhost:8006/swagger-ui.html 可以正常访问

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70][]

如上图所示，页面显示正常，但是在Idea控制台却报错，如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 1][]

# 二、问题原因 #

## 2.1 为什么会报错？ ##

java.lang.NumberFormatException: For input string: ""，**根据报错内容显示，是因为输入了 空字符串""，而空字符串无法转为 Number 类型。**

## 2.2 问题排查 ##

由于这是在通过浏览器访问Swagger时控制台报的错，那么我们就从控制台中的swagger报错信息开始查找，如下图红框内显示，**AbstractSerializableParameter.java这个类的getExample方法。**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 2][]

按住键盘的Ctrl 键，点击**AbstractSerializableParameter类，**进入swagger的源码查看（在抛出异常的位置打上断点，并以Debug模式启动：）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 3][]

浏览器中刷新swagger文档（重新进入swagger文档），程序停在断点处：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 4][]

通过断点，我们找到了问题，那么我们就可以做对应的修改了，也就是为对应的属性上加上**`example`**属性就好了，如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 5][]

## 2.3 哪种情况会报这样的错？ ##

目前，只发现了把实体属性用作参数，并且参数类型不是`application/json`时，就会出现这个错。如下图所示：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 6][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 7][]

## 2.4 为什么上述情况会报错？ ##

上述情况也就是把实体属性用作参数，并且参数类型不是`application/json`时，**io.swagger.models.parameters.AbstractSerializableParameter** 会实例化参数，也就是通过**example**的值为属性赋值，如果**example**没有显示赋值，就是空串""，但是如果实体类用作 **application/json** 那么就不会走这个方法去实例化参数。

# 三、解决方案 #

## 3.1 第一种解决方案 ##

把项目里面的使用这种属性的情况，也就是在@ApiModelProperty注解里面写上 example = “1”，其实就是给出一个示例，具体写1还是2或3都无所谓，但要注意一点是 example 对应的值必须是Integer类型的。如2.2中一样。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 5][]

## 3.2 第二种解决方案 ##

既然存在这种问题，开发者不会没有发现吧，然后就去看了看swagger-models的其他版本，发现在**swagger-models:1.5.20**版本是**springfox-swagger2:2.9.2**里面依赖的版本，既然是依赖，那就自己引用了一个**swagger-models:1.5.21**的版本，然后看看源码，发现 在新的版本中进行了改正。于是我把swagger-models:1.5.20版本排除了，然后单独引入了swagger-models:1.5.21版本。

再次通过浏览器访问swagger-ui发现问题得到解决。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 8][]

完结！

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70]: /images/20221022/fe072aa870224f848954ef8b92446258.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 1]: /images/20221022/c907f4f9288f40199bfd5a713e19cf0b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 2]: /images/20221022/22d6986788fd48d4b10bf16a18820a4a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 3]: /images/20221022/3cbe5371c7ae4a5fb69c50ad522724fd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 4]: /images/20221022/1068044424f44e13a4d128c714df4886.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 5]: /images/20221022/eda69ceb3c814ba98ed0d2f724c1ee1b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 6]: /images/20221022/ddb9145be6724f7f8d0e2e51b13d61b9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 7]: /images/20221022/00c18695ccf642ffbf869c32cc90b3f6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 8]: /images/20221022/1e0067d0193343dbacc27f742147b389.png