swagger相关问题

swagger相关问题

swagger版本为：

    com.github.xiaoymin
    swagger-bootstrap-ui
    1.9.6


    io.springfox
    springfox-swagger2
    2.9.2


    io.springfox
    springfox-swagger-ui
    2.9.2

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