Swagger2.9.2进入API界面报NumberFormatException异常


问题定位

Swagger2.9.2版本,在访问swagger首页的时候,控制台报错。

WARN 19699 --- [nio-1111-exec-4] i.s.m.p.AbstractSerializableParameter    : Illegal DefaultValue null for parameter type integer

java.lang.NumberFormatException: For input string: ""
    at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) ~[na:1.8.0_171]
    at java.lang.Long.parseLong(Long.java:601) ~[na:1.8.0_171]
    at java.lang.Long.valueOf(Long.java:803) ~[na:1.8.0_171]
    at io.swagger.models.parameters.AbstractSerializableParameter.getExample(AbstractSerializableParameter.java:412) ~[swagger-models-1.5.20.jar:1.5.20]
    at sun.reflect.GeneratedMethodAccessor109.invoke(Unknown Source) ~[na:na]
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_171]
    at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_171]
    at com.fasterxml.jackson.databind.ser.BeanPropertyWriter.serializeAsField(BeanPropertyWriter.java:687) [jackson-databind-2.9.6.jar:2.9.6]

根据错误日志查看swagger2.9.2源代码swagger-models-1.5.20.jar中io.swagger.models.parameters.AbstractSerializableParameter第412行,发现是由于实体类使用@ApiModelProperty时,example属性没有赋值导致的,在AbstractSerializableParameter的getExample方法中会将数值属性的example的转换数值类返回,example的默认值是"",因此当example没有赋值时,会出现上面的异常。

swagger-models-1.5.20中源代码:

解决方法

1.将每一个数值类型上@ApiModelProperty的example都赋值数字字符串

2.修改源文件,重新打个包

3.使用1.5.22版本jar包替换

swagger-models-1.5.22中源代码:

替换:

4.修改springboot输出日志,将io.swagger.models.parameters.AbstractSerializableParameter文件的日志级别设置成error

声明:Wayen|版权所有,违者必究|如未注明,均为原创|本网站采用BY-NC-SA协议进行授权

转载:转载请注明原文链接 - Swagger2.9.2进入API界面报NumberFormatException异常


-当你感到最无助困难的时候,那就是离成功最近的时候。-Martin Frohm