ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

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

2026/9/26 12:09:06 拓冰建站 浏览量
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;