【swagger】springboot中swagger无法显示的问题

问题表现如下：

添加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包的目录结构

所以上述配置的作用，应该是怕swagger-ui.html找不到资源，所以添加了一下资源的搜索路径。到这里了，还是没有解决swagger-ui加载为空的问题。

于是尝试chrome debug一下（mac 下 F12是快捷键）

chrome debug

第一个（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等。

最后编辑于：2019.09.25 21:55:26