问题表现如下:
添加swagger的配置之后,启动浏览器输入:http://127.0.0.1:8090/swagger-ui.html
于是网上搜索了一下swagger的错误,大部分提供的解决方式如下。
添加如下配置:
```java
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**").addResourceLocations(
"classpath:/static/");
registry.addResourceHandler("/swagger-ui.html").addResourceLocations(
"classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**").addResourceLocations(
"classpath:/META-INF/resources/webjars/");
super.addResourceHandlers(registry);
}
```
一堆配置的地址,不太明白,于是看了一下swagger这个包里面的东西,发现其目录结构如下:
所以上述配置的作用,应该是怕swagger-ui.html找不到资源,所以添加了一下资源的搜索路径。到这里了,还是没有解决swagger-ui加载为空的问题。
于是尝试chrome debug一下(mac 下 F12是快捷键)
第一个(x):typography.css的报错
idea打开swagger的源文件,文件为空,暂时不管这个错误,源文件就没有内容。
第二个(x):先点开traceback的中的链接,就是黑色文字的这些,发现是可以访问到js代码的,说明资源是可以正常访问。
继续深入....
点开报错的脚本,利用chrome的代码format打开看到报错的代码行如下
加上断点之后调试,看下这里传入的是什么?
根本不是我们期待的:/swagger-ui.html,甚至不是一个合法的url,难怪会open这个url的时候报错。我们浏览器输入的是/swagger-ui.html,为什么到了swagger的代码中响应的url不是如此了。debug到这里猜到了原因。
我们在做web工程的时候通常会写一些拦截器。
比如我这个工程,我对于所有的web响应,错误和正确的都会用拦截器转化为以下格式
{"code":0, "message":"ok","data":""}
为了接口的统一,以上做法很常见,正是拦截器的存在导致swagger的响应参数不被swagger识别。
所以再修改拦截器,对于swagger的请求不拦截即可。
问题解决!!!
ps:我们的拦截器处理得比较暴力,是根据返回类型来判断是否是业务服务的请求。用类型判断的话,swagger拦截器需要处理的类型有:SpringFox的Json, LinkedHashMap,ArrayList等。