转自:
最近项目开始使用Swagger作为Api文档的编写工具，Swagger确实是为开发工作带来了很多方便。但是偶尔总会出现明明接口说明已经修改了，但在doc.html上总是看到旧的字段描述。甚至有时字段已经删除了，不管怎么重启，怎么清缓存，还是赖着在那里。
今天无意间打开了“Swagger Models”菜单，发现界面上显示的model数量怎么那么少，跟我服务端的代码的类的数量相差较大。所以去看了一下后端代码，并对比了下“Swagger Models”里面的模型详情。终于被我发现了这个巨坑的根本原因，原来我在定义@ApiModel时写的value值时一样的，Swagger并没有报错，而是默默的帮我把两个类的字段合在一起。代码及效果如下图所示：
因篇幅问题不能全部显示，请点此查看更多更全内容