这两天在搭建项目用到了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")

得此解决!