第13章 常見問題與解決方案
13.1 Spring MVC 關于controller的字符編碼
13.2 Spring Boot啟動報錯
13.3 javax.servlet.ServletException
13.4 庫依賴沖突問題
13.5 org.apache.catalina.LifecycleException
13.6 @EnableMongoRepositories路徑配置
13.7 Logging system failed to initialize using configuration from 'logback.xml '
13.8 java.lang.IllegalArgumentException: Request header is too large
13.9 No handler found for GET /swagger-ui.html
我們在使用SpringBoot集成Swagger2中潭陪，訪問：http://127.0.0.1:8188/swagger-ui.html
問題描述
可能出現(xiàn)兩種錯誤：
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相關的所有前端靜態(tài)文件都在springfox-swagger-ui-2.6.1.jar里面池颈。目錄如下：
Spring Boot自動配置本身不會自動把/swagger-ui.html這個路徑映射到對應的目錄META-INF/resources/下面些己。我們加上這個映射即可锄禽。代碼如下：
@Configuration
class WebMvcConfig extends WebMvcConfigurerAdapter {
@Override
void 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來完成擦酌。
