【SpringBoot】配置静态资源

SpringBoot中有两项静态资源配置项：
1、spring.mvc.static-path-pattern
2、spring.resources.static-locations
配置出差错时，导致404错误，找不到静态资源；

1、 spring.mvc.static-path-pattern

它代表的是应该以什么样的路径来访问静态资源，也就是只有静态资源满足什么样的匹配条件，Spring Boot才会处理静态资源请求。官方的配置为：

# 这里表示只有静态资源的访问路径为/resources/**时，才会处理请求
spring.mvc.static-path-pattern = /resources/**

假定采用默认的配置端口，那么只有请求地址类似于“http://localhost:8080/resources/jquery.js”时，Spring Boot才会处理此请求，处理方式是将根据模式匹配后的文件名查找本地文件，那么应该在什么地方查找本地文件呢？这就是“spring.resources.static-locations”的作用了。

2、 spring.resources.static-locations

这是一个列表性的配置，用于说明静态资源文件的查找路径，查找文件是会依赖于配置的先后顺序依次进行，默认的官方配置如下：

spring.resources.static-locations = classpath:/static,classpath:/public,classpath:/resources,classpath:/META-INF/resources

继续以上面的请求地址为例，“http://localhost:8080/resources/jquery.js”就会在上述的四个路径中依次查找是否存在“jquery.js”文件，如果找到了，则返回此文件，否则返回404错误。

2.1、配置file路径

需要指定的是一个具体的硬盘路径时，需要使用file，其他的使用classpath指的是系统环境变量;

file.uploadFolder = /home/uploadFiles/
spring.resources.static-locations = classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,file:${file.uploadFolder}

3、静态资源的Bean配置

“spring.mvc.static-path-pattern”与“spring.resources.static-locations”组合起来演绎了nginx的映射配置，如果熟悉Spring MVC，那么理解起来更加简单，它们的作用可以用Bean配置表示，如下：

@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/resources/**")
                .addResourceLocations("/public-resources/")
                .setCacheControl(CacheControl.maxAge(1, TimeUnit.HOURS).cachePublic());
    }
}

或者等同与以下的XML；

4、总结

“spring.mvc.static-path-pattern”用于阐述HTTP请求地址，而“spring.resources.static-locations”则用于描述静态资源的存放位置。

 

注：

这里特别说明下上述配置中提到的classpath。SpringBoot项目创建完成后，会生成该项目名称+iml后缀的文件。该文件位于项目的根目录下。打开后，在name="NewModuleRootManager"的component声明中，会有几个默认content声明。其中sourceFolder 中声明的就是classpath，只是类型不同。