快捷導(dǎo)航

SpringBoot靜態(tài)資源映射規(guī)則淺析

更新時(shí)間：2023年02月27日 11:32:28 作者：哈密瓜Q

這篇文章主要介紹了SpringBoot靜態(tài)資源映射規(guī)則，今天在玩SpringBoot的demo的時(shí)候,放了張圖片在resources目錄下,啟動(dòng)區(qū)訪問(wèn)的時(shí)候,突然好奇是識(shí)別哪些文件夾來(lái)展示靜態(tài)資源的, 為什么有時(shí)候放的文件夾不能顯示,有的卻可以

1. 靜態(tài)資源映射規(guī)則

在項(xiàng)目中雙擊shift或ctrl+N搜索WebMvcAutoConfiguration.class文件，文件中的addResourceHandlers方法如下：

public void addResourceHandlers(ResourceHandlerRegistry registry) {
    if (!this.resourceProperties.isAddMappings()) {
        logger.debug("Default resource handling disabled");
    } else {
        this.addResourceHandler(registry, "/webjars/**", "classpath:/META-INF/resources/webjars/");
        this.addResourceHandler(registry, this.mvcProperties.getStaticPathPattern(), (registration) -> {
            registration.addResourceLocations(this.resourceProperties.getStaticLocations());
            if (this.servletContext != null) {
                ServletContextResource resource = new ServletContextResource(this.servletContext, "/");
                registration.addResourceLocations(new Resource[]{resource});
            }
        });
    }
}

隨后進(jìn)入到getStaticLocations()方法可以發(fā)現(xiàn)變量 staticLocations 的取值如下：

"classpath:/META-INF/resources/"
"classpath:/resources/"
"classpath:/static/"
"classpath:/public/"

即項(xiàng)目運(yùn)行時(shí)會(huì)到上述路徑下尋找靜態(tài)資源，也可以自定義靜態(tài)資源路徑，需在 application.properties 中配置：

spring.resources.static-locations=classpath:/folder1/,classpath:/folder2/

注：一旦自定義了靜態(tài)文件夾的路徑，則默認(rèn)的靜態(tài)資源路徑就會(huì)失效。

2. 歡迎頁(yè)

靜態(tài)資源路徑下的 index.html 文件會(huì)被/**所映射，當(dāng)訪問(wèn)http://localhost:8080/時(shí) ，會(huì)默認(rèn)映射到靜態(tài)資源文件夾下的 index.html。

遇到的問(wèn)題

新建 index.html 文件后運(yùn)行項(xiàng)目，訪問(wèn)http://localhost:8080/時(shí)會(huì)頁(yè)面錯(cuò)誤：

控制臺(tái)報(bào)如下錯(cuò)誤：

Spring Boot 的版本是 2.7.8，tomcat 的版本是 9.0.71。Spring Boot 通過(guò)內(nèi)嵌的 tomcat 來(lái)運(yùn)行項(xiàng)目，但需要依靠本地的 java 環(huán)境，我本地的 java 版本是 Java 1.8.0_261（即 java 8 版本），一般 java 8 和 tomcat 8.x.x 配套使用，這里可能是版本沖突導(dǎo)致的問(wèn)題。將項(xiàng)目的 SDK 改為jbr-11 JetBrains Runtime version 11.0.10即可解決問(wèn)題：