Springboot下swagger-ui.html訪問不到的解決方案

Springboot swagger-ui.html訪問不到

問題

在前面的Swagger2的基本配置中是可以訪問到swagger-ui.html的

但當自定義繼承配置WebMvcConfigurationSupport後便無法訪問到該頁面,原因參考請看參考資料。

首先看我的自定義配置,

*************
 * HttpMessageConverter轉換處理
 * 處理轉義hmtl標簽為正常的hmtl標簽
 * @author [email protected]
 *
 */
@Configuration
public class WebConfig extends WebMvcConfigurationSupport {
    @Bean
    public MappingJackson2HttpMessageConverter customJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.configure(
                DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        objectMapper.getSerializerProvider().setNullValueSerializer(
                new JsonSerializer<Object>() {
                    @Override
                    public void serialize(Object value, JsonGenerator jgen,
                            SerializerProvider provider) throws IOException,
                            JsonProcessingException {
                        jgen.writeString("");
                    }
                });
        // 進行HTML解碼
        objectMapper.registerModule(new SimpleModule().addSerializer(
                String.class, new JsonSerializer<String>() {
                    @Override
                    public void serialize(String value, JsonGenerator jgen,
                            SerializerProvider provider) throws IOException,
                            JsonProcessingException {
                        jgen.writeString(StringEscapeUtils.unescapeHtml4(value));
                    }
                }));
        jsonConverter.setObjectMapper(objectMapper);
        return jsonConverter;
    }
    @Override
    public void configureMessageConverters(
            List<HttpMessageConverter<?>> converters) {
        converters.add(customJackson2HttpMessageConverter());
        super.addDefaultHttpMessageConverters(converters);
    }
}

如果我把該文件全部註釋掉則會正常顯示,否則無法訪問到swagger-ui.html,

解決方法

如果繼承瞭WebMvcConfigurationSupport,則在配置文件在中配置的相關內容會失效,需要重新指定靜態資源

因此參照資料2我做瞭處理如下,在該代碼的末尾加上靜態資源配置

代碼加在

*************
 * HttpMessageConverter轉換處理
 * 處理轉義hmtl標簽為正常的hmtl標簽
 * @author [email protected]
 *
 */
@Configuration
public class WebConfig extends WebMvcConfigurationSupport {
    @Bean
    public MappingJackson2HttpMessageConverter customJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.configure(
                DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        objectMapper.getSerializerProvider().setNullValueSerializer(
                new JsonSerializer<Object>() {
                    @Override
                    public void serialize(Object value, JsonGenerator jgen,
                            SerializerProvider provider) throws IOException,
                            JsonProcessingException {
                        jgen.writeString("");
                    }
                });
        // 進行HTML解碼
        objectMapper.registerModule(new SimpleModule().addSerializer(
                String.class, new JsonSerializer<String>() {
                    @Override
                    public void serialize(String value, JsonGenerator jgen,
                            SerializerProvider provider) throws IOException,
                            JsonProcessingException {
                        jgen.writeString(StringEscapeUtils.unescapeHtml4(value));
                    }
                }));
        jsonConverter.setObjectMapper(objectMapper);
        return jsonConverter;
    }
    @Override
    public void configureMessageConverters(
            List<HttpMessageConverter<?>> converters) {
        converters.add(customJackson2HttpMessageConverter());
        super.addDefaultHttpMessageConverters(converters);
    }
    /**
     * 發現如果繼承瞭WebMvcConfigurationSupport,則在yml中配置的相關內容會失效。 需要重新指定靜態資源
     * 
     * @param registry
     */
    @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);
    }
    /**
     * 配置servlet處理
     */
    @Override
    public void configureDefaultServletHandling(
            DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }
}

swagger-ui的坑,swagger-ui.html無顯示

且返回200無報錯,且/v2/api-docs可以正常訪問

因為粗心,踩中的坑,代碼規范,細心真的能節省很多時間

上圖,界面顯示如圖,一切都正常,控制臺,也沒有報錯,很詭異吧

docs卻可以正常訪問,包括接口,都是正常的,網上很多解決方案都是說,跨域問題,或者是靜態資源訪問不到

1,首先跨域問題,會報錯,有很明顯的報錯提示,這裡排除,

2,靜態資源,可以參考csdn上的其他方案很多,排查方法,可以查看targer目錄下是否有靜態文件

現在說這個問題導致的原因,以及解決方案

由於當時再寫監聽器相關代碼,裡面還涉及到過濾器,網上說到swagger會和攔截器有沖突,所以一直錯誤認為是監聽器導致的問題,而且還有fastdfs的相關代碼,也有說這兩個起沖突,沒辦法,一一排查,進行版本回滾,發現fasdfs這個版本沒有問題,這裡要說,平時開發一定要切分支,分支切不瞭也要多提交版本,這樣一旦出現問題也好解決。

然後下個版本發現,加上監聽器,問題就又出現瞭,把監聽器所有代碼註釋掉,問題依舊,百思不得其解,無奈,地毯掃描,版本不一樣的全部註釋,直到註釋到controller層,又正常瞭,非常懷疑,一個controller,service業務代碼這些不應該導致出問題的,怎麼會是這的問題,然後進入代碼準備細查,打開代碼驚喜就來瞭

這是代碼,本來還準備去看service層,看下是不是業務上有什麼代碼報錯,到這就感覺更奇怪瞭,什麼代碼都沒寫,去掉就正常瞭,然後搜一下是不是方法名重復瞭,發現沒有,

這時發現:@RequestMapping(),對就是這個註解,裡面沒東西是什麼鬼,估計是當時註釋的時候直接給刪掉瞭,加入值後一切恢復正常

現在想想,swagger本來就是對controller的提取,沒有報錯就可以懷疑接口問題。

以上為個人經驗,希望能給大傢一個參考,也希望大傢多多支持WalkonNet。

推薦閱讀: