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

更新時間：2021年10月13日 10:07:34 作者：牧竹子

這篇文章主要介紹了Springboot下swagger-ui.html訪問不到的解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教

Springboot swagger-ui.html訪問不到

問題

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

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

首先看我的自定義配置,

*************
 * HttpMessageConverter轉換處理
 * 處理轉義hmtl標簽為正常的hmtl標簽
 * @author zjcjava@163.com
 *
 */
@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，則在配置文件在中配置的相關內容會失效，需要重新指定靜態(tài)資源

因此參照資料2我做了處理如下，在該代碼的末尾加上靜態(tài)資源配置

代碼加在

*************
 * HttpMessageConverter轉換處理
 * 處理轉義hmtl標簽為正常的hmtl標簽
 * @author zjcjava@163.com
 *
 */
@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);
    }
    /**
     * 發(fā)現(xiàn)如果繼承了WebMvcConfigurationSupport，則在yml中配置的相關內容會失效。 需要重新指定靜態(tài)資源
     * 
     * @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可以正常訪問

因為粗心，踩中的坑，代碼規(guī)范，細心真的能節(jié)省很多時間

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

docs卻可以正常訪問，包括接口，都是正常的，網(wǎng)上很多解決方案都是說，跨域問題，或者是靜態(tài)資源訪問不到

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

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

現(xiàn)在說這個問題導致的原因，以及解決方案

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

然后下個版本發(fā)現(xiàn)，加上監(jiān)聽器，問題就又出現(xiàn)了，把監(jiān)聽器所有代碼注釋掉，問題依舊，百思不得其解，無奈，地毯掃描，版本不一樣的全部注釋，直到注釋到controller層，又正常了，非常懷疑，一個controller，service業(yè)務代碼這些不應該導致出問題的，怎么會是這的問題，然后進入代碼準備細查，打開代碼驚喜就來了