1. 发现问题
在启动项目后,打开Swagger2,就会看到控制台疯狂报错,基本都是For input string:""
2. 分析问题
2.1. 常见原因
这种错误在平时写代码时很常见。
常见情况是:后台接收参数的类型限定为int,但用户什么都没输入
试图将"“解析成int,便会报出这样的错误
原因在于int的默认值是0,对于字符串”"无法解析
解决办法:接收参数的类型改成Integer
Integer是封装过的int类,默认值是null而不是0
2.2. Swagger2为什么报这个错?
报错的原因是 尝试将"“解析成int
但自己的代码明明没有任何地方写到了”"
百度以后,发现问题出在example属性
报错原因总结如下:
(1) @ApiModelProperty或@ApiImplicitParam注解中没有写example属性,而这个注解对应的属性类型恰好是Integer。
(2) 由于Integer的默认值是"",在没有写example时,example的默认值被设置成了""
(3) 但Swagger2只会解析int,于是在尝试将""解析成int的时候,便疯狂报错。每有一个这样的注解,便报一次这样的错误。
2.3. 解决方案
2.3.1. 降级
据说可以降级解决,好像说2.8.0就可以了,但我没有去尝试
毕竟大部分人都选择2.9.2,想必该版本有它的好处
2.3.2. 修改依赖
其实说到底,这是Swagger2的一个BUG。
Swagger2在2.9.2版本及以后,依赖的swagger-models版本都默认为1.5.20
这个版本就存在这样的BUG,但在1.5.21版本就修改了这个BUG
将Maven中设置Swagger2依赖的代码,改成如下:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
<exclusions>
<exclusion>
<groupId>io.swagger</groupId>
<artifactId>swagger-annotations</artifactId>
</exclusion>
<exclusion>
<groupId>io.swagger</groupId>
<artifactId>swagger-models</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>io.swagger</groupId>
<artifactId>swagger-annotations</artifactId>
<version>1.5.21</version>
</dependency>
<dependency>
<groupId>io.swagger</groupId>
<artifactId>swagger-models</artifactId>
<version>1.5.21</version>
</dependency>
注意只需要替换掉Swagger2依赖的代码
也就是这个:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
问题便可以解决