swagger相关问题

swagger相关问题

swagger版本为：

<dependency><groupId>com.github.xiaoymin</groupId><artifactId>swagger-bootstrap-ui</artifactId><version>1.9.6</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>2.9.2</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>2.9.2</version>
</dependency>

swagger的doc.html页面不显示接口信息

出现原因：由于在String类型字段上，使用ApiModelProperty注解时example写入数据为特殊格式，例如：“{json}”，导致swagger前端ui奔溃

@ApiModelProperty(value = "test",example = "{json}")
private String test;

解决办法：将大括号去掉即可，example中尽量不要添加类似大括号等特殊字符！

报警告日志

日志信息为：

[WARN] [http-nio-8018-exec-4] io.swagger.models.parameters.AbstractSerializableParameter 421 - Illegal DefaultValue null for parameter type integer java.lang.NumberFormatException: For input string: ""

出现原因：

ApiParam注解用于Integer类型时需要加example，且写入值必须是int类型

@ApiParam(value = "任务id",example = "1") @NotNull @RequestParam Integer id