关于Swagger2报错java.lang.NumberFormatException: For input string: ""的总结_swagger2 .numberformatexception: for input string:-优快云博客

本文链接：https://blog.youkuaiyun.com/choath/article/details/103785607

本文详细解析了在使用Swagger时遇到的NumberFormatException异常原因，主要涉及int或long类型字段的example属性缺失导致的问题，并提供了两种有效的解决方案：一是为字段添加example属性；二是升级swagger-models依赖版本至1.5.21，以支持对空字符串的正确处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

首先,说明一下报错的原因:

第一种情况:

    @ApiModelProperty(value = "排序", example = "1")
    private int sort_order;

如上代码,如果实体类中,int类型或者long类型字段,没有写example = "1"这个默认值的话,swagger会默认为""空字符串,所以字符串转数字,就有了NumberFormatException这个异常!

解决办法: 加上 example = "1" 即可!

第二种情况:

 @ApiImplicitParams({
            @ApiImplicitParam(name = "page", value = "页码", required = true, dataType = "int", defaultValue = "1"),
            @ApiImplicitParam(name = "rows", value = "每页的行数", required = true, dataType = "int", defaultValue = "10"),
            @ApiImplicitParam(name = "code", value = "搜索条件--类型代码", dataType = "String"),
            @ApiImplicitParam(name = "name", value = "搜索条件--类型名称", dataType = "String"),
            @ApiImplicitParam(name = "sidx", value = "排序字段", dataType = "String"),
            @ApiImplicitParam(name = "sord", value = "正序--asc,倒序--desc", dataType = "String")
    })

如上代码,这是接口上面的@ApiImplicitParams注解,其中前端给传的page和rows,并非是实体类的字段,这样就没办法通过第一种方法去解决了.本人遇到的就是第二种情况,没办法只能看报错,打断点调试,最终定位到是这两个字段的原因后,结合源码获得了答案!

源码中只判断了examole==null,忽略了""空字符串的情况!

解决办法:

其一,改源码jar包,再通过maven依赖进来,这个比较麻烦,后来找到了一个心的方法

其二,io.springfox:springfox-swagger2:2.9.2中依赖了swagger-models的1.5.20版本，我们可以排除springfox-swagger2中的swagger-models依赖，导入io.swagger:swagger-models的1.5.21版本即可。因为1.5.21版本添加了对""空字符传的判断!

如下图: