记一次Swagger页面报错/error 404的排查过程

使用springfox-swagger-ui展示的页面如下:

说是没有为/error这个路径指明确定的映射.
前后端使用的json传输数据格式,我也确实没有编码哪个controller中包含/error这样的映射,如果是框架把它当做页面的转发,那我也没有一个这样的ViewModel,而且我的控制层明确使用的是@RestController,不是转发页面的Controller.
所以问题出在Maven引用和配置文件上.

Maven引用

这个引用不会有问题,原因很简单–使用者众多,而且已经更新到这个版本了,若有问题早就有更新版本覆盖了
网上有很多人都遇到过Swagger-ui.html页面加载不出来的情况,大部分也都是404,很多帖子都是在WebMvcConfig里配置addResourceHandlers加载静态资源,Swagger的配置类上加@EnableSwagger2注解,以及明确RequestHandlerSelectors基础包的扫描路径这一套操作.后来我在解决了这个问题后自己试了一下,Swagger的配置类肯定是要中规中矩的按API描述配置,但是WebMvcConfig却可以不用配置也能出页面.
那就是别的地方的配置文件导致了页面出不来.

一步步排查config包下的配置文件,最终发现关于FastJsonConfig的配置类如果注释掉,Swagger页面会正常显示,
我的FastJsonConfig是继承自WebMvcConfigurationSupport后重写
configureMessageConverters方法的,重写的方法里不涉及/error映射,所以最终是因为WebMvcConfigurationSupport里的方法产生的问题.
现在为了使用configureMessageConverters方法里的json转换功能,产生了额外的耦合,所以换个思路,自己写一个fastJson的配置类,不继承WebMvcConfigurationSupport,说不定就能解决问题.于是我的最终的json配置类改成了这样的:

启动OK,页面出来了:

另外,这个swagger-ui可以与swagger-bootstrap-ui并存互补,各自单独显示也都不影响: