Springfox2.6.1+SpringMVC+Swagger2配置手记

最近一直在捣鼓Swagger的事情，起初使用Swagger1可以配个 swagger-springmvc成功，但是它配合SpringMVC项目如果是一个上传文件就不太友好了，无法展示上传文件的按钮，所以有上传文件，图片的api就无法使用了！！！！

百度了好一阵子，在万能的stackoverflow上终于得到答案，国内的搜索网站贴吧这点儿真的有些逊色了，没有关于这方面的解决方案，还是靠我微薄的英语知识搜索到的，原来 swagger-springmvc1.0.2（最新的）已经过时了，已经被springfox取代了 ！！！！！！！！

好吧，伐开心！好不容易熬了几个通宵配置起来的swagger就这样夭折了。

那就继续研究springfox的swagger配置；

现在时刻的当前版本是springfox2.6.1；果断maven下来

    <dependency>            <groupId>io.springfox</groupId>            <artifactId>springfox-swagger2</artifactId>            <version>${springfox.version}</version>        </dependency>        <dependency>            <groupId>io.springfox</groupId>            <artifactId>springfox-swagger-ui</artifactId>            <version>${springfox.version}</version>        </dependency>

在然后写配置：

@Configuration // 配置注解@EnableWebMvc // 启用Mvc //非springboot框架需要引入注解@EnableWebMvc@EnableSwagger2 // 启用Swagger2，毕竟SpringFox的核心依旧是Swagger// @ComponentScan(basePackages = "com.june.controller.back.common.*")//然而并没有卵用public class SwaggerConfig extends WebMvcConfigurerAdapter {    @Bean    public Docket customDocket() {        return new Docket(DocumentationType.SWAGGER_2).select()// 选择哪些路径和API会生成document                .apis(RequestHandlerSelectors.any())// 对所有api进行监控                .paths(PathSelectors.any())// 对所有路径进行监控                .build().apiInfo(apiInfo());    }// */    private ApiInfo apiInfo() {        return new ApiInfo(PROJ, DESC, VERS, SERV, new Contact(NAME, URL, CONT), LICS, L_URL);    }}

小弟的所有配置都是参考了这位CSDN的仁兄的博客
好吧开开心心的（其实并不开心，工作好好的，就今天公司说辞就辞，把一位一起工作的同事给辞掉了，很震惊也很愤怒，更为自己考虑考虑），
然后运行，心想这个应该不会有问题了，因为以前的swagger1已经配置的very very good了，至少运行是没有任何问题的，结果呵呵哒！

352198 [localhost-startStop-1] DEBUG o.s.b.f.s.DisposableBeanAdapter - Invoking destroy method 'close' on bean with name 'dataSource'352207 [localhost-startStop-1] ERROR o.s.web.context.ContextLoader - Context initialization failedorg.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is com.google.common.util.concurrent.ExecutionError: java.lang.StackOverflowError    at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:176)    at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:51)    at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:346)    at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:149)    at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:112)    at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:852)    at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:541)    at org.springframework.web.context.ContextLoader.configureAndRefreshWebApplicationContext(ContextLoader.java:444)    at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:326)    at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:107)    at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4853)    at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5314)    at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:145)    at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1408)    at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1398)    at java.util.concurrent.FutureTask.run(FutureTask.java:266)    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)    at java.lang.Thread.run(Thread.java:745)Caused by: com.google.common.util.concurrent.ExecutionError: java.lang.StackOverflowError    at com.google.common.cache.LocalCache$Segment.get(LocalCache.java:2201)    at com.google.common.cache.LocalCache.get(LocalCache.java:3937)    at com.google.common.cache.LocalCache.getOrLoad(LocalCache.java:3941)    at com.google.common.cache.LocalCache$LocalLoadingCache.get(LocalCache.java:4824)    at com.google.common.cache.LocalCache$LocalLoadingCache.getUnchecked(LocalCache.java:4830)    at springfox.documentation.spring.web.scanners.CachingOperationReader.read(CachingOperationReader.java:57)    at springfox.documentation.spring.web.scanners.ApiDescriptionReader.read(ApiDescriptionReader.java:66)    at springfox.documentation.spring.web.scanners.ApiListingScanner.scan(ApiListingScanner.java:89)    at springfox.documentation.spring.web.scanners.ApiDocumentationScanner.scan(ApiDocumentationScanner.java:70)    at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.scanDocumentation(DocumentationPluginsBootstrapper.java:85)    at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:127)    at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:173)    ... 18 common frames omittedCaused by: java.lang.StackOverflowError: null    at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)    at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)    at com.fasterxml.classmate.types.ResolvedRecursiveType.equals(ResolvedRecursiveType.java:157)    at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)    at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)    at com.fasterxml.classmate.types.ResolvedRecursiveType.equals(ResolvedRecursiveType.java:157)    at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)    at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)

这个问题废了两天也没解决掉，是因为国内研究springfox太少的缘故么，至少网上搜索的时候发现大部分有关springfox的介绍都是2016年底的文章，看来又到我发挥英语的时候啦，注意下面的关键词，在百度输入：“swagger2.6.0 can not work well with springmvc ”，蓝后搜索，还是万能的stackoverflow给力了，
解决问题，在这个贴最后发现一位仁兄这样总结的：

a work around is to rollback to springfox-swagger2 2.5.0 .

呵呵，现在正在研究 spring2.5.0了……有成果了在了分享！