Swagger提示请确保swagger资源接口正确

问题描述

在项目开发过程中集成swagger-bootstrap-ui，打开swagger-ui.html页面正常，但是打开doc.html页面提示"请确保swagger资源接口正确"。

原因分析：

原因是JSON格式非法，一般出现此情况时，是因为后端在给属性赋予了exmpale属性时，赋值了json字符串导致。

比如：

@ApiModelProperty(value = "客户字段数据",example = "{'id':'xxx'}")
private List<String> fields;

@ApiModelProperty(value = "参数数据",example = "{'name':'xxx'}")
private String param;

解决方案：

把属性中的example去掉，或者把单引号替换成转义后的双引号

@ApiModelProperty(value = "客户字段数据",example = "{\"id\":\"xxx\"}")
private List<String> fields;

@ApiModelProperty(value = "参数数据",example = "{\"name\":\"xxx\"}")
private String param;