关于使用swagger 中接口显示入参和代码中配置的不一致(错误)import io.swagger.annotations.ApiModel;使用错误

╰半橙微兮° 2021-10-09 08:50 1280阅读 0赞
  1. 定义接口的时候,发现进入swagger ui显示接口的入参参数和我代码中的不一致?
  2. 并且两个接口的入参显示一样,但是实际上我代码中引用的是两个入参对象的。不一样的参数。
  3. 起初以为是浏览器缓存、服务器缓存,都clean了,还是一样。怎么回事?
  4. 先把代码贴出来。看看
  5. 很明显,是两个不一样的接口,两个入参对象,下图为两个入参对象的数据结构。
  6. 很明显,两个不一样的对象,但是为什么引用了同一个入参对象呢?????
  7. 仔细一端详,哦。。。。。。@ApiModel配置了同一个名字,也就是说,按照顺序来说,两个接口都引用了同一个对象来作为入参对象。那我们就其注解,看看这个配置有什么作用??
  8. @ApiModel("文章保存入参")

复制网上一个兄弟的图片,我没有找到这个swagger的文档

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zNzM4MDc4NA_size_16_color_FFFFFF_t_70

value 备用名,默认值为类名,所以,如果我们自定义了名字,那么就会出现名称冲突,但是swagger没报错。然后呢,引用的时候就出问题了。出现了两个一样名字的对象,他优先取第一个对象 。就出现了上述情况。

希望大家别踩坑了。。。

发表评论

表情:
评论列表 (有 0 条评论,1280人围观)

还没有评论,来说两句吧...

相关阅读