springboot + swagger2注意点

springboot + swagger2注意点

1、如果在配置文件中设置了spring.mvc.converters.preferred-json-mapper:gson
会导致swagger失效，换成Jackson就行。或者不在配置文件中写，用代码配置自定义解析器。
2、controller的返回值写明参数类型,如：ResultDto；如此在文档中可以清晰看到返回值类型。
3、@ApiOperation() 描述接口信息。
4、@ApiImplicitParam() 描述接口参数信息，如果参数是List，设置allowMultiple = true即可。
5、@ApiModelProperty()描述字段信息；具体字段作用请看源码。