静态资源从入门到精通，一点就透！

2023-02-17 11:47:31

SpringBoot 静态资源加载原理详解

在现代 Web 开发中，静态资源（例如 CSS、JS 和图像）对于提供交互性和美观至关重要。SpringBoot 作为领先的 Java 框架，为管理和加载静态资源提供了简洁高效的机制。让我们深入了解其背后的原理。

静态资源加载原理

SpringBoot 将静态资源存储在 resources 目录中，并进一步组织为子目录（例如 css、js 和 image）。当浏览器请求一个静态资源时，SpringBoot 根据请求的 URL 将资源解析到其物理路径，并将其返回给浏览器。

涉及的关键类

ResourceHttpRequestHandler： 处理静态资源请求的 HttpRequestHandler 类。
ResourceHandler： 配置静态资源映射关系，包括 addResourceLocations() 方法，用于添加物理路径。
DefaultServletHttpRequestHandler： 处理非静态资源请求的 HttpRequestHandler 类。
WebMvcConfigurer： 配置 Spring MVC 的接口，包括 addResourceHandlers() 方法，用于添加静态资源映射。

加载流程

浏览器发起对静态资源的请求。
DispatcherServlet 将请求转发给 ResourceHttpRequestHandler 或 DefaultServletHttpRequestHandler。
根据 URL，解析静态资源的物理路径。
读取并返回静态资源的内容。

常见问题解答

加载不到静态资源？
- 检查资源路径是否正确。
- 检查映射关系是否已配置。
- 检查 Web 服务器是否已正确配置。
- 检查日志是否有错误信息。

如何添加自定义映射关系？

在 WebMvcConfigurer 类中使用 addResourceHandlers() 方法。例如：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/custom/**")
            .addResourceLocations("classpath:/custom/");
}

如何设置缓存头？

使用 ResourceChainResolver 类配置缓存头。例如：

@Bean
public ResourceChainResolver resourceChainResolver() {
    ResourceChainResolver resolver = new DefaultResourceChainResolver();
    resolver.addResolver(new VersionResourceResolver().addFixedVersionStrategy("1.0"));
    return resolver;
}

如何处理压缩资源？

使用 ResourceHttpRequestHandler 类启用压缩。例如：

@Bean
public ResourceHttpRequestHandler resourceHttpRequestHandler() {
    ResourceHttpRequestHandler handler = new ResourceHttpRequestHandler();
    handler.setLocations(Arrays.asList(new ClassPathResource("/")));
    handler.setCacheSeconds(0);
    handler.setGzipEnabled(true);
    return handler;
}

如何禁用静态资源加载？
- 在 WebMvcConfigurer 类中设置 WebMvcConfigurer.addResourceHandlers() 为空。例如：
```
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {}
```