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。
推薦閱讀:
- Springboot 全局時間格式化操作
- springboot jackson自定義序列化和反序列化實例
- 解決springboot 2.x 裡面訪問靜態資源的坑
- SpringBoot返回對象時,如何將Long類型轉換為String
- Spring Boot統一返回體的踩坑記錄