swagger2踩的坑

swagger2踩的坑

Scroll Down

这两天在搭建项目用到了swagger,遇到了不少坑,可以说是完全没必要踩到的坑,却让我浪费了许久时间,确实很难受,记录下来,以此为教训!

先说明下:
版本号为:springboot2.x、swagger2.7+
我遇到了很多问题,第一个:
file

上面那个错表示swagger没有配置好,即配置问题

找原因:找swagger-ui.html 请求分发过程,
file
没有找到swagger-ui的hmtl,返回error,,紧接着,看一下页面报404的接口,去掉null访问一下,
file

访问成功!

file
于是在springmvc的源码上定位该接口的bean,即public org.springframework.http.ResponseEntity springfox.documentation.swagger.web.ApiResourceController.uiConfiguration()
file

定位到该接口,查看其源码,即
file

于是在请求一下,得到它的数据,以及返回值!这个时候得到了一个关键的线索点,它的返回值!!!
在查看了项目的统一返回值包装类之后恍然大悟,这特么是我的封装类将swagger本身的返回值结构打破了,所以swagger没有解析到
正确的返回值,所以会报这个错,蓝瘦~
file

如下,是我们的返回值和swagger自己定义的返回值:
file
file

结果已经很明了了!就是我们的包的作用范围的原因,应该缩小一下范围,即加入下面代码:

@RestControllerAdvice(basePackages = "com.xxxxx.controller")

得此解决!