问题描述
每次启动完项目,访问swagger-ui网页时,控制台就报错。
虽然不影响项目正常运行,但看起来非常闹心,
于是提供一下解决方案给同样是重度强迫症的小伙伴们。
异常信息
可见:异常为NumberFormatException,因为空字符串""不能转成Long类型所以报错。
调试,验证异常信息
可见在
io.swagger.models.parameters.AbstractSerializableParameter.getExample(AbstractSerializableParameter.java:412) 的 return Long.valueOf(example);语句的确由于example默认值为空串""而发生了NumberFormatException异常并被抓住打印了日志信息。
解决方案
经调查,属于swagger2自身的bug,并提出了issue,且已经有人给出了解决方案。
swagger-models-1.5.20会报错了,而1.5.21版本已经修复。
issue:https://github.com/springfox/springfox/issues/2265
解决方案: 替换swagger-models-1.5.20为1.5.21版本
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
<!--移除swagger-models 1.5.20 依赖,存在Swagger2异常:Illegal DefaultValue null for parameter type integer问题-->
<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.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</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>
ps:
swagger2需要引用两个依赖,一个是springfox-swagger2,另一个是springfox-swagger-ui。而springfox-swagger2又引用了swagger-models,swagger-models又引用了swagger-annotations。
因此,需要把swagger-models和swagger-annotations这两个子依赖一并替换为1.5.21版本。
完美解决,撒花庆祝✿✿ヽ(°▽°)ノ✿