使用Swagger时Controller中api接口显示不全的问题分析及解决
作者:一米阳光zw
swagger是一个十分好用的api接口管理、测试框架,现在越来越多的人使用这个做接口的测试和管理,但经常遇到Controller中的api接口显示不全的问题,所以本文给大家详细分析了问题以及解决方法,需要的朋友可以参考下
前言:
swagger是一个十分好用的api接口管理、测试框架,现在用的人也越来越多,lz两个公司两个项目都有使用这个做接口的测试和管理,由于之前就遇到过Controller中的api接口显示不全的问题,但当时使用postman直接忽略掉了,这个项目刚启动时就在想是不是会遇到类似的奇葩问题,果然是担心什么就会来什么,今天,它来了。花了很久的时间对接口进行了处理,找出了问题所在。先看一下具体的表现
问题
主要问题就是controller中有三个接口,但是swagger界面中只显示了两个,看下面具体的问题
- 先看一下controller中的代码,看似没什么问题,合情合理
- swagger中的表现
问题解决
问题的原因是api的映射路径重复,将swagger中未显示出来的接口的映射路径更换成其他的就可以,如下图所示。分析:这是由于controller中的接口映射路径重复造成的,实际上我的/test/upload已经在其他的测试类中出现过了,所以在这个地方又加了就无法显示这一个api,只需将其更换成其他名字就OK
最后
以上就是使用Swagger时Controller中api接口显示不全的问题分析及解决的详细内容,更多关于Swagger Controller的api显示不全的资料请关注脚本之家其它相关文章!