使用Swagger时Controller中的api接口显示不全问题

前言:

swagger是一个十分好用的api接口管理、测试框架,现在用的人也越来越多,lz两个公司两个项目都有使用这个做接口的测试和管理,由于之前就遇到过Controller中的api接口显示不全的问题,但当时使用postman直接忽略掉了,这个项目刚启动时就在想是不是会遇到类似的奇葩问题,果然是担心什么就会来什么,今天,它来了。花了很久的时间对接口进行了处理,找出了问题所在。先看一下具体的表现


问题

主要问题就是controller中有三个接口,但是swagger界面中只显示了两个,看下面具体的问题

  • 先看一下controller中的代码,看似没什么问题,合情合理
    使用Swagger时Controller中的api接口显示不全问题
  • swagger中的表现
    使用Swagger时Controller中的api接口显示不全问题

问题解决

问题的原因是api的映射路径重复,将swagger中未显示出来的接口的映射路径更换成其他的就可以,如下图所示。分析:这是由于controller中的接口映射路径重复造成的,实际上我的/test/upload已经在其他的测试类中出现过了,所以在这个地方又加了就无法显示这一个api,只需将其更换成其他名字就OK
使用Swagger时Controller中的api接口显示不全问题


********************* 转载注明出处,谢谢 ***********************