swagger上的model和返回的数据字段不一致的问题

今天遇到一个奇怪的问题，就是接口返回的数据和swagger调用接口后展示的数据有区别 数据库中的数据 可以看出当我phone为hk12345时对应的user_id为1380508531521015809 接口返回的数据 可以看出我接口返回的user_id也是1380508531521015809 swagger显示的数据 可以看到swagger显示的userId和之前的不同，但是又很相似 后面发现id太长，数据失真了，只要在实体类的属性上加上@JsonFormat(shape= Json

在项目开发定义接口过程中，我使用swagger生成接口文档时发现入参多了一个参数。

Spring的pageable对象接收分页参数时的字段与swagger上的不一致 在写分页接口时用到了pageable对象 使用@PageableDefault注解可以达到收到默认分页参数的效果 具体使用：sort = "created", direction = Sort.Direction.DESC 然后在项目中使用的swagger来构建接口文档，在swagger上显示的pageable参数字段是 但是实际接收参数的字段是： /** * Page index parameter name.

下面是我写的javaBean @Data @ApiModel(value = "图片传入数据实体",description = "图片传入数据实体") public class TSourInfo { @NotNull(message = "铭牌id不能为空！") @ApiModelProperty(value = "铭牌id",required = true) private Long nameplateId; @ApiModelProperty(value = "图片名

一、背景 由于项目controller封装的通用返回类不规范，是用继承HashMap实现的，没有使用泛型，导致swagger生成接口文档无法讲返回model自动生成，十分影响和前端对接，@ApiResponses又不支持泛型，于是需要多写点代码兼容 R类代码片段如下 public class R extends HashMap<String, Object> { private static final long serialVersionUID = 1L; public static

突然前端说：接口不好使，我试了试发现好用呀，前端扔过来一张图片：传的参数和我定义的完全不一样，撕逼一通发现是swagger的问题 swagger中的参数和实际代码中不一样，经过咨询度娘发现定义@ApiModel的时候，有两个类的value值相同，这样的情况下swagger认为这个同一个东西，会优先取第一个（盗一个图，原作者看到的备注下原博文的链接哈） 写代码还是要多多注意噻~ ...

无意间发现，swagger展示的字段和自己接口中的字段不一样，但是调用后，响应的数据是正常的。 排查。 swagger截图： 接口字段： 原因： 项目中有两个ContentItem，名字一样造成的。

@ApiModel("实体类名称") 可能原因是定义实体类的时候@ApiModel在多个类上有重复命名的。

注解中相应参数或者删除实体类上该注解即可。去除通用响应实体类上。

问题描述： 使用swagger过程中，针对接口返回值包含的结构体Class A使用注解说明后，发现接口描述信息中返回值对应并不是对应的实体类Class A,而是变为了类Class B，当然class B对应的类属性也不会是class A的属性。 问题剖析 @ApiModel("这是class A的描述") public class A { @ApiModelProperty("id") pri...

转自:https://blog.csdn.net/SwellHuang/article/details/103284035 一个我一直以为是Swagger缓存的巨坑，今天终于解决了 最近项目开始使用Swagger作为Api文档的编写工具，Swagger确实是为开发工作带来了很多方便。但是偶尔总会出现明明接口说明已经修改了，但在doc.html上总是看到旧的字段描述。甚至有时字段已经删除了，不管怎么重启，怎么清缓存，还是赖着在那里。 期间一直以为时缓存的问题，各种请浏览器缓存，换浏览器，甚至删除操作系统

后端对象属性设置前端传递的参数不一致。

ApiModel是Swagger中的常用到的注解，检查下信息错误的实体类的@ApiModel的value值是否一致，应该是写错了，是不是张冠李戴了。

swagger中参数和实际代码中不一致的问题