前言：
我們都知道，SpringBoot啟動會默認加載很多xxxAutoConfiguration類(自動配置類)
其中SpringMVC的大都數功能都集中在WebMvcAutoConfiguration類中，根據條件ConditionalOnxxx注冊類對象；WebMvcAutoConfiguration滿足以下ConditionalOnxxx條件，類是生效的，并把其對象注冊到容器中。

那WebMvcAutoConfiguration生效給容器中配置了什么呢？
WebMvcAutoConfigurationAdapter靜態內部類

一、配置文件前綴

我們來看WebMvcAutoConfiguration類中的WebMvcAutoConfigurationAdapter靜態內部類：

這是一個配置類，配置文件的屬性和xxx進行了綁定。
再看@EnableConfigurationProperties({WebMvcProperties.class, ResourceProperties.class, WebProperties.class})
我們來看當中的WebMvcProperties、ResourceProperties和WebProperties的字節碼文件
分別點進這三個類的字節碼文件中：

可以看到：
WebMvcProperties它是與配置文件前綴spring.mvc相關聯的。
ResourceProperties它是與配置文件前綴spring.resources相關聯。
WebProperties它是與配置文件前綴spring.web相關聯。

二、只有一個有參構造器

WebMvcAutoConfigurationAdapter靜態內部配置類只有一個有參數的構造器，那它會帶來什么特性呢？
它的有參構造器中所有參數的值都會從容器中確定

public WebMvcAutoConfigurationAdapter(ResourceProperties resourceProperties, WebProperties webProperties, WebMvcProperties mvcProperties, ListableBeanFactory beanFactory, ObjectProvider<HttpMessageConverters> messageConvertersProvider, ObjectProvider<WebMvcAutoConfiguration.ResourceHandlerRegistrationCustomizer> resourceHandlerRegistrationCustomizerProvider, ObjectProvider<DispatcherServletPath> dispatcherServletPath, ObjectProvider<ServletRegistrationBean<?>> servletRegistrations) {this.resourceProperties = (Resources)(resourceProperties.hasBeenCustomized() ? resourceProperties : webProperties.getResources());this.mvcProperties = mvcProperties;this.beanFactory = beanFactory;this.messageConvertersProvider = messageConvertersProvider;this.resourceHandlerRegistrationCustomizer = (WebMvcAutoConfiguration.ResourceHandlerRegistrationCustomizer)resourceHandlerRegistrationCustomizerProvider.getIfAvailable();this.dispatcherServletPath = dispatcherServletPath;this.servletRegistrations = servletRegistrations;this.mvcProperties.checkConfiguration();}

我們來看下它的參數：

• 第一個參數是ResourceProperties resourceProperties 就是我們上面提到的@EnableConfigurationProperties({WebMvcProperties.class,ResourceProperties.class,
  WebProperties.class})中注冊開啟的第二個類，獲取和spring.resources綁定的所有的值的對象
• 第二個參數是WebProperties webProperties 就是我們上面提到的@EnableConfigurationProperties({WebMvcProperties.class,
  ResourceProperties.class,WebProperties.class})中注冊開啟的第三個類，獲取和spring.web綁定的所有的值的對象
• 第三個參數是WebMvcProperties mvcProperties 就是我們上面提到的@EnableConfigurationProperties({WebMvcProperties.class,ResourceProperties.class,
  WebProperties.class})中注冊開啟的第一個類，獲取和spring.mvc綁定的所有的值的對象
• 第四個參數是ListableBeanFactory beanFactory ，這個是Spring的beanFactory，也就是我們的容器。
• 第五個參數是ObjectProvider
  messageConvertersProvider，找到所有的HttpMessageConverters
• 第六個參數是ObjectProvider<WebMvcAutoConfiguration.ResourceHandlerRegistrationCustomizer> resourceHandlerRegistrationCustomizerProvider，找到資源處理器的自定義器
• 第七個參數是ObjectProvider dispatcherServletPath，相當于找dispatcherServlet能處理的路徑
• 第八個參數是ObjectProvider<ServletRegistrationBean<?>> servletRegistrations
  ，給應用注冊原生的Servlet、Filter等等

構造器初始化后，我們已經把所有的東西從容器中拿到了

三、源碼分析addResourceHandlers方法

所有的資源處理默認規則都在addResourceHandlers方法中，如下：

public void addResourceHandlers(ResourceHandlerRegistry registry) {if (!this.resourceProperties.isAddMappings()) {logger.debug("Default resource handling disabled");} else {Duration cachePeriod = this.resourceProperties.getCache().getPeriod();CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();if (!registry.hasMappingForPattern("/webjars/**")) {this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{"/webjars/**"}).addResourceLocations(new String[]{"classpath:/META-INF/resources/webjars/"}).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl).setUseLastModified(this.resourceProperties.getCache().isUseLastModified()));}String staticPathPattern = this.mvcProperties.getStaticPathPattern();if (!registry.hasMappingForPattern(staticPathPattern)) {this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{staticPathPattern}).addResourceLocations(WebMvcAutoConfiguration.getResourceLocations(this.resourceProperties.getStaticLocations())).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl).setUseLastModified(this.resourceProperties.getCache().isUseLastModified()));}}}

禁用掉靜態資源的路徑映射
我們打上斷點看它的默認規則是怎么起作用的，首先調用resourcePropertoes的isAddMappings()方法：

判斷this.resourcePropertoes的isAddMappings()方法是不是不為true，

• this.resourcePropertoes我們剛才在2中講構造器時講到的ResourceProperties
  resourceProperties 就是我們上面提到的@EnableConfigurationProperties({WebMvcProperties.class,
  ResourceProperties.class, WebProperties.class})中注冊開啟的第二個類，獲取和spring.resources綁定的所有的值的對象
• isAddMappings()方法返回的是this.addMappings的值，如下：

也就是說我們可以通過設置addMappings的值是false還是true來讓這個if語句是否執行
我們可以在配置文件中進行設置：

默認它是true，如果是false，那么他就進入if語句中，執行logger.debug("Default resource handling disabled");后結束該方法，else中的所有配置都不生效

else中的什么配置/webjars/**去哪找等等一些規則都不生效了。
也就是說我們通過設置add-mappings: false 來禁用掉了靜態資源的路徑映射。
禁用后所有的靜態資源都訪問不了了。

addMappings的值如果是true，那么他就不會進入if語句中，而是進入到else語句中，那么else語句的內容都得到了執行，下面我們看它是怎么配置靜態資規則的。

源碼分析webjars的底層規則
進入到else語句中，第一行是Duration cachePeriod = this.resourceProperties.getCache().getPeriod();，它從resourceProperties里面獲取到關于緩存的相關值。我們在yaml配置文件中配置一下這個值:

緩存時間是以秒為單位的，如下：

意思就是我們所有的靜態資源默認可以緩存存儲多少秒

我們debug接著往下走，看到cachePeriod中取到了剛剛yaml中設置的6666，以后我們的瀏覽器就會把我們的靜態資源緩存6666秒:

debug接著往下走，我們到了注冊"/webjars/**"這個規則的地方：

if (!registry.hasMappingForPattern("/webjars/**")) {this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{"/webjars/**"}).addResourceLocations(new String[]{"classpath:/META-INF/resources/webjars/"}).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl).setUseLastModified(this.resourceProperties.getCache().isUseLastModified()));}

也就是說我們訪問/webjars下面的所有請求都找我們的classpath:/META-INF/resources/webjars/路徑，其中還設置了其靜態資源的緩存時間為6666秒。
拿jquery來舉例，為什么我們導入jquery之后，我們只需要訪問/webjars/jquery/3.5.1/jquery.js就能夠訪問到/META-INF/resources/webjars/jquery/3.5.1/jquery.js，如下：

其緩存時間也可以在瀏覽器中看到為6666秒：

源碼分析默認靜態資源路徑的底層規則
我們在else里面接著往下debug，接著我們用mvcProperties屬性調用其getStaticPathPattern()方法

• this.mvcProperties我們剛才在2中講構造器時講到的WebMvcProperties mvcProperties 就是我們上面提到的@EnableConfigurationProperties({WebMvcProperties.class, ResourceProperties.class, WebProperties.class})中注冊開啟的第一個類，獲取和spring.mvc綁定的所有的值的對象
• getStaticPathPattern()方法，這個方法返回的是staticPathPattern的值，如下：
  

staticPathPattern的這個值可以在我們的配置文件中進行配置，它的默認值是/**，如下：

我們也可以把前綴配置成/resource/**，如下：

debug接著往下走，接下來調用的方法與上面的webjars是一樣的方法，只不過參數有所不同：

接下來我們具體看代碼：

String staticPathPattern = this.mvcProperties.getStaticPathPattern();if (!registry.hasMappingForPattern(staticPathPattern)) {this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{staticPathPattern}).addResourceLocations(WebMvcAutoConfiguration.getResourceLocations(this.resourceProperties.getStaticLocations())).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl).setUseLastModified(this.resourceProperties.getCache().isUseLastModified()));}

把剛剛的前綴staticPathPattern得到后作為實參傳入hasMappingForPattern方法中，注冊前綴這個規則，剛剛我們在yaml中設置了前綴為/resource/**，也就是說我們訪問/resource/**下面的所有請求都找我們的this.resourceProperties.getStaticLocations() 路徑，其中也設置了其靜態資源的緩存時間為6666秒。
this.resourceProperties.getStaticLocations()方法返回的值是什么呢？我們點進去看一下：

this.resourceProperties.getStaticLocations()返回的是this.staticLocations，這個staticLocations定義如下：

可以看到它是一個字符串數組，在無參構造器中進行了初始化，初始化的值是CLASSPATH_RESOURCE_LOCATIONS常量，常量的值為：

• “classpath:/META-INF/resources/”,
• “classpath:/resources/”,
• “classpath:/static/”,
• "classpath:/public/“

這就解釋了靜態資源路徑為什么默認為這四個路徑。

四、歡迎頁的處理規則

HandlerMapping：處理器映射。保存了每一個Handler能處理哪些請求。 @Beanpublic WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext,FormattingConversionService mvcConversionService, ResourceUrlProvider mvcResourceUrlProvider) {WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(new TemplateAvailabilityProviders(applicationContext), applicationContext, getWelcomePage(),this.mvcProperties.getStaticPathPattern());welcomePageHandlerMapping.setInterceptors(getInterceptors(mvcConversionService, mvcResourceUrlProvider));welcomePageHandlerMapping.setCorsConfigurations(getCorsConfigurations());return welcomePageHandlerMapping;}WelcomePageHandlerMapping(TemplateAvailabilityProviders templateAvailabilityProviders,ApplicationContext applicationContext, Optional<Resource> welcomePage, String staticPathPattern) {if (welcomePage.isPresent() && "/**".equals(staticPathPattern)) {//要用歡迎頁功能，必須是/**logger.info("Adding welcome page: " + welcomePage.get());setRootViewName("forward:index.html");}else if (welcomeTemplateExists(templateAvailabilityProviders, applicationContext)) {// 調用Controller /indexlogger.info("Adding welcome page template: index");setRootViewName("index");} }

總結

以上是生活随笔為你收集整理的SpringBoot静态资源配置原理(源码)的全部內容，希望文章能夠幫你解決所遇到的問題。

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