13.9 SpringBoot集成Swagger2中遇到的問題

我們在使用SpringBoot集成Swagger2中，訪問：http://127.0.0.1:8188/swagger-ui.html

問題描述

可能出現兩種錯誤：
1.頁面顯示默認報錯頁面。后臺報錯：

No handler found for GET /swagger-ui.html

2.顯示Swagger空白頁面：

后臺報錯：

No mapping found for HTTP request with URI [/swagger-resources/configuration/ui] in DispatcherServlet with name 'dispatcherServlet'

解決方案

這個錯誤，是因為資源映射問題導致。
我們在訪問http://127.0.0.1:8188/swagger-ui.html 時，這個swagger-ui.html相關的所有前端靜態文件都在springfox-swagger-ui-2.6.1.jar里面。目錄如下：

Spring Boot自動配置本身不會自動把/swagger-ui.html這個路徑映射到對應的目錄META-INF/resources/下面。我們加上這個映射即可。代碼如下：

@Configuration class WebMvcConfig extends WebMvcConfigurerAdapter {@Overridevoid addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/")registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/")}}

同時，在啟動類上添加注解@EnableWebMvc。完整的Spring Boot集成Swagger2構建自動化Rest API文檔工程示例，源碼參考：

當然，為了更加方便使用SpringBoot集成swagger，這個工作可以直接通過定制swagger-starter來完成。

總結

以上是生活随笔為你收集整理的13.9 SpringBoot集成Swagger2中遇到的问题的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。