swagger2.9.2接口文档显示问题

swagger版本:2.9.2

框架:springboot2.1.2

 

当没有使用

 @ApiImplicitParam和response=Resp.class时,swagger会自动去显示接口入参对象的各属性,及响应的对象属性,如下图:

swagger2.9.2接口文档显示问题

swagger2.9.2接口文档显示问题

swagger2.9.2接口文档显示问题

 

而如果加入@ApiImplicitParam和response=Resp.class时,则没有任务字段属性显示,如下:

swagger2.9.2接口文档显示问题

 

所以建议,当接口的入参为几个字段属性时可以加上@ApiImplicitParam进行描述,如果是对象,则只要在该 VO对象用@ApiModel和@ApiModelProperty进行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger会自动进行解析。swagger2.9.2接口文档显示问题