第一个坑
今天,就在今天.又发生了一个灵异事件!Swagger上面接口展开,请求参数展开什么信息也没有.如下图所示 :
确定所有的Swagger注解都么得问题,按照规范来的 ,
@RequestBody也加上了 .百思不得其姐,搜索!!
最后百度了一大圈也么得结果 ,看了看他与其他Dto的定义 ,就一个不同点, 那就是这个我在 @ApiModel()里面使用了 /,试着将 /删除了会不会好 .重启完毕 ,真特么好了 ,坑爹啊.记录下
修改为
就好了~好了.
第二个坑
都记录到这里了,再说下上次遇到的另一个关于 Swagger的坑吧 .记得那是一个风黑月高的加班夜,我写好接口后.直接给前端小姐姐说接口下好了,自己 Swagger上看一下 .结果她写好后,各种 undefined,找到我.我当然不能背锅啊,虽然是个漂亮小姐姐,但是和我有关系吗.一看字段的定义,我就说,你有没有看接口文档啊,那么多字段都对不上的 .小姐姐委屈坏了,说看过了,和她的一模一样.我当然得用事实击败她了, 当着她的面打开了 Swagger ,结果真特么和她写的一模一样. 这下轮到我在风中饱受白眼的凌乱了 ,上天何其不公啊,要让我这样丢脸 !!
没办法继续找问题所在吧 ,发现这个接口的dto和另一个接口的dto的 @ApiModel里面的东西是一样的.而且正是Swagger上面的合集.好了,问题应该就在这里了 .避免再次出错 ,按这个搜索了一下.果然是这样,别人也踩到了这个坑,哈哈哈,吾道不孤啊!!!
总结
@ApiModel内的注释不要出现相同,否则会将相同实体内的字段合并显示(应该和版本相关，但是我就没去深入了).
