最近一直在搗鼓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 failed
org.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 omitted
Caused 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了……有成果了在了分享！