swagger使用问题收集

1. 打开swagger-ui时后台报错java.lang.NumberFormatException: For input string: “”

报错的原因是pom引入的io.springfox:springfox-swagger-ui:2.92版本的jar包内置为io.swagger:swagger-models包为1.5.20版本。1.5.20版本中判断example只判断是否为null，没有判断example为空字符串"“的情况所以报错。1.5.21版本新增了判断example是否为null和”"，所以排除1.5.20包重新导入1.5.21包即可解决
解决方案是：

<!-- swagger2-UI-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
    <exclusions>
        <exclusion>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-models</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- io.springfox:springfox-swagger2:2.9.2中依赖了swagger-models的1.5.20版本，通过排除springfox-swagger2中的swagger-models依赖，
导入io.swagger:swagger-models的1.5.21版本.解决io.swagger.models.parameters.AbstractSerializableParameter实例化参数时example为
空字符串""而报错的问题.因为1.5.20的example只判断是否为null,1.5.21判断了是否为null和""-->
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.21</version>
</dependency>

参考：https://blog.csdn.net/bad_yixiong/article/details/96343823

2. swagger不能传递参数（报错是java.lang.IllegalStateException: ）

出现这种情况，修改paramType=”query”,或者为header，或者不写这条属性
例如：

@ApiImplicitParams({
        @ApiImplicitParam(paramType="query", name = "loginname", value = "手机号码", required = true, dataType = "String"),
        @ApiImplicitParam(paramType = "query", name = "password", value = "密码", required = true, dataType = "String"),
        @ApiImplicitParam(paramType = "query", name = "classifyVersionCode", value = "客户端分类版本号", required = true, dataType = "Integer"),
        @ApiImplicitParam(paramType = "query", name = "ap    pVersionCode", value = "客户端apk版本号", required = true, dataType = "Integer"),
        @ApiImplicitParam(paramType = "query", name = "userType", value = "客户端类型", required = true, dataType = "Integer")
    })

@ApiImplicitParam(value = "主题站的类别id",name = "id",required = true,dataType = "int",defaultValue = "7")

3. 注释get请求的参数

使用@ApiParam注解，例：

public WrapperResponse<List<NursingInfoRespVO>> queryNursingMapByAreaDivide(@ApiParam(name = "areaDivideId", value = "片区id", required = true)
                                                                            @RequestParam Long areaDivideId) {
        return WrapperResponse.success(nursingAnalyzeService.queryNursingMapByAreaDivide(areaDivideId));
    }

参考：https://blog.csdn.net/qq_20516587/article/details/81109842