如何在SpringBoot中设置HTTP缓存，你知道么？

柔情只为你懂 2023-01-23 08:58 10阅读 0赞

**点击关注公众号，利用****碎片时间学习****![2818924ca41cc91e80be0aa005dc759f.png][]**

## 介绍 ##

在工作之余阅读缓存相关的书籍时，看到了http缓存相关的知识，HTTP 缓存机制是一个 web 性能优化的重要手段，无论是做前端还是做web后台，都可能会用得到它，应该是知识体系库中的一个基础环节，以前这一块学的不是很扎实，现在整理资料巩固巩固。

**HTTP缓存可以说是浏览器缓存的其中一种，浏览器缓存也包含很多内容：HTTP 缓存、indexDB、cookie、localstorage 等等。这里我们只讨论 HTTP 缓存相关内容。**

浏览器主要分为`Last-Modified/Etag`和`Cache-Control/Expires`

其中`Cache-Control/Expires`属于强缓存，`Last-Modified/Etag`属于协商(比较)缓存

## cache-control ##

![0b108affceb91a30c05b6af54370edfe.png][]

`cache-control`字段位于这里，像这样设置的`cache-control`是没有缓存的

**在请求中使用`Cache-Control` 时，它可选的值有：**

[![7c06a7cfe00d2382255a4621b4c7e362.png][]][7c06a7cfe00d2382255a4621b4c7e362.png 1]

**在响应中使用Cache-Control 时，它可选的值有：**

![358488d4371dbc70c5e81ff2e7c7623b.png][]

在`Cache-Control` 中，这些值可以自由组合，多个值如果冲突时，也是有优先级的，而`no-store`优先级最高。

像`cache-control`这种强缓存是性能高的，它不需要请求服务器，就直接从本地加载文件了，后面的`Last-Modified/Etag`是需要请求服务器来验证文件的。

**在实际使用中，浏览器会先验证强缓存**，所以对于js、css、img文件的过期时间可以设置非常长，因为前端构建工具打包出来的文件是有利于缓存的，比如可以配置webpack打包后的js文件跟个hash值，就可以根据hash来判断文件是否发生变化。在打包出来的文件名上加上文件内容的hash是目前最常见的有效使用浏览器强缓存的方法，js文件如果有内容更新，hash就会更新，浏览器请求路径变化所以更新缓存，如果js内容不变，hash不变，直接用缓存，下面的etag也有类似的思想。

**如果对于变化频繁的文件就不要加`cache-control`了**，如果配置cache-control的过期时间比较长的话，由于`cache-control`优先级比`Last-Modified/Etag`高，所以会在过期时间内不会更新文件。

## Expires ##

关于Expires：

*  Expires 是以前用来控制缓存的http头，Cache-Control是新版的API。
 *  现在首选 Cache-Control。
 *  如果在Cache-Control响应头设置了 “max-age” 或者 “s-max-age” 指令，那么 Expires 头会被忽略。
 *  响应头设置方式：Expires: Wed, 21 Oct 2015 07:28:00 GMT
 *  Expires 响应头包含日期/时间， 即在此时候之后，响应过期。

> 注意：因为过期标准的时间用的是本地时间，所以不靠谱，所以要使用`Cache-Control`代替Expires。

关于第三点：一般会把`Cache-Control`和Expires都设置上，因为 Expires 是 HTTP 1.0 定义的字段，而 `Cache-Control` 是 HTTP 1.1 的字段，万一客户端只支持 HTTP 1.0，那么 `Cache-Control` 有可能就会不工作，所以一般为了兼容会都写上。

![db08307e6049fd47979b62e05e7e5289.png][]

`Cache-Control`设置时间长度、Expires 设置时间点

## Last-Modify/If-Modify-Since ##

浏览器第一次请求一个资源的时候，服务器返回的 header中会加上`Last-Modify`，`Last-modify`是一个时间标识该资源的最后修改时间。

![9a9cf919c328db94427a4da1e28dd1aa.png][]

当浏览器再次请求该资源时，发送的请求头中会包含`If-Modify-Since`，该值为缓存之前返回的`Last-Modify`。服务器收到`If-Modify-Since`后，根据资源的最后修改时间判断是否命中缓存。

![e57d904352f158e8a176a4739d567639.png][]

如果命中缓存，则返回http304，并且不会返回资源内容，并且不会返回`Last-Modify`。由于对比的服务端时间，所以客户端与服务端时间差距不会导致问题。但是有时候通过最后修改时间来判断资源是否修改还是不太准确（资源变化了最后修改时间也可以一致）。于是出现了`ETag/If-None-Match`。

## Etag/If-None-Match ##

经过上面的缓存后，若[未命中强缓存][Link 1]，则浏览器会将请求发送至服务器。服务器根据http头信息中的`Last-Modify/If-Modify-Since`或`Etag/If-None-Match`来判断是否命中协商缓存。如果命中，则http返回码为304，浏览器从缓存中加载资源。

与`Last-Modify/If-Modify-Since`不同的是，`Etag/If-None-Match`返回的是一个校验码（ETag: entity tag）。ETag可以保证每一个资源是唯一的，资源变化都会导致ETag变化。ETag值的变更则说明资源状态已经被修改。服务器根据浏览器上发送的`If-None-Match`值来判断是否命中缓存。

![f1ef7f8b7d49558e21db5d6536f5d43a.png][]

ETag是HTTP1.1中才加入的一个属性，用来帮助服务器控制Web端的缓存验证。它的原理是这样的，当浏览器请求服务器的某项资源(A)时, 服务器根据A算出一个哈希值(`3f80f-1b6-3e1cb03b`)并通过 ETag 返回给浏览器，浏览器把"`3f80f-1b6-3e1cb03b`" 和 A 同时缓存在本地，当下次再次向服务器请求A时，会通过类似 `If-None-Match`: “`3f80f-1b6-3e1cb03b`” 的请求头把ETag发送给服务器，服务器再次计算A的哈希值并和浏览器返回的值做比较，如果发现A发生了变化就把A返回给浏览器(200)，如果发现A没有变化就给浏览器返回一个304未修改。这样通过控制浏览器端的缓存，可以节省服务器的带宽，因为服务器不需要每次都把全量数据返回给客户端。

HTTP中并没有指定如何生成Etag，可以自己定义一种好的方式来生成Etag

通过etag，实际上还是要向服务器发送一次请求，但是把资源文件缓存下来了，减少服务器带宽。

## 总结 ##

**Last-Modified与 Etag对比**

你可能会觉得使用Last-Modified已经足以让浏览器知道本地的缓存副本是否足够新，为什么还需要Etag（实体标识）呢？HTTP1.1中Etag的出现主要是为了解决几个Last-Modified比较难解决的问题：

*  Last-Modified标注的最后修改只能精确到秒级，如果某些文件在1秒钟以内，被修改多次的话，它将不能准确标注文件的修改时间。
 *  如果某些文件会被定期生成，当有时内容并没有任何变化，但Last-Modified却改变了，导致文件没法使用缓存。
 *  有可能存在服务器没有准确获取文件修改时间，或者与代理服务器时间不一致等情形。

Etag是服务器自动生成或者由开发者生成的对应资源在服务器端的唯一标识符，能够更加准确的控制缓存。`Last-Modified`与ETag是可以一起使用的，服务器会优先验证ETag，一致的情况下，才会继续比对`Last-Modified`，最后才决定是否返回304。

![7bc55c6b84a09d07bad9d1c39696cbf8.png][] [![97875b1f9650ea76036207bb81926a49.png][]][97875b1f9650ea76036207bb81926a49.png 1]

浏览器第一次和第二次请求对比，**这张图反映出优先级：ETag优先级 > Last-Modified优先级、cache-control优先级 > expires优先级。**

**用户操作与缓存**

![3fb432ac0663dc1ad366d8d6663c44de.png][]

# 在spring boot中开启http缓存 #

**本地测试环境：**

*  [Spring boot版本][Spring boot]: 2.1.3.RELEASE
 *  项目前后端通过ajax交互，前端文件全部放在src/main/resources/static目录下，跟后台一起部署。

**实操：**

#### 配置Cache-Control ####

在spring boot中，发现没有经过http缓存相关的配置默认是这样子的，response带有不使用缓存的http头，导致每次加载都要从服务端获取数据，而有些静态资源文件是不必要每次从服务器去获取的，像常用的js库、css库什么的。

![75048e96874cf621a5b4468ee7c0b2d7.png][]

Spring boot配置`cache-control`和expires可以通过`WebMvcConfigurationSupport`来配置，也可通过修改配置文件的方式，这里使用配置类的方式。

这里需要注意的是，使用`WebMvcConfigurationSupport`会使`WebMvcAutoConfiguration`的自动配置不生效，因为`WebMvcAutoConfiguration`里面有个`@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)`，表现为默认的一些映射路径无法访问，如果想保留默认的配置，那就使用implements WebMvcConfigurer的方式来配置

@Configuration
    public class WebConfigConfigurer extends WebMvcConfigurationSupport {
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            registry.addResourceHandler("/static/**")
                    .addResourceLocations("classpath:/static/")
                    .setCacheControl(CacheControl.maxAge(604800, TimeUnit.SECONDS));
        }
    }

这里将`src/main/resources/static`目录映射到`/static`的url下，然后setCacheControl就可以了。

spring.resources.cache.cachecontrol.cache-private= # Indicate that the response message is intended for a single user and must not be stored by a shared cache.
    spring.resources.cache.cachecontrol.cache-public= # Indicate that any cache may store the response.
    spring.resources.cache.cachecontrol.max-age= # Maximum time the response should be cached, in seconds if no duration suffix is not specified.
    spring.resources.cache.cachecontrol.must-revalidate= # Indicate that once it has become stale, a cache must not use the response without re-validating it with the server.
    spring.resources.cache.cachecontrol.no-cache= # Indicate that the cached response can be reused only if re-validated with the server.
    spring.resources.cache.cachecontrol.no-store= # Indicate to not cache the response in any case.
    spring.resources.cache.cachecontrol.no-transform= # Indicate intermediaries (caches and others) that they should not transform the response content.
    spring.resources.cache.cachecontrol.proxy-revalidate= # Same meaning as the "must-revalidate" directive, except that it does not apply to private caches.
    spring.resources.cache.cachecontrol.s-max-age= # Maximum time the response should be cached by shared caches, in seconds if no duration suffix is not specified.
    spring.resources.cache.cachecontrol.stale-if-error= # Maximum time the response may be used when errors are encountered, in seconds if no duration suffix is not specified.
    spring.resources.cache.cachecontrol.stale-while-revalidate= # Maximum time the response can be served after it becomes stale, in seconds if no duration suffix is not specified.

如果要使用配置的方式也很简单，上面这些是关于cache的配置，在spring boot官方文档最后的附录里面有。

![7b3fecc65f07b4d0e32c7c1e0b72ac97.png][]

再来测试，首先把[缓存开启][Link 2]，它这个选项就是通过request headers里的CacheControl实现的。

![e33de4869fdcec548f76bf74cf7e6d8c.png][]

然后刷新发现已经使用了http缓存。

![a23730ab2f5a43088087da20d2b50bb4.png][]

发现已经不是之前默认的no-store了，而是变为我们自己设置的缓存过期时间了，说明已经在使用http的强缓存了！

小提示：这个`addResourceHandler`和`addResourceLocations`不要弄反了，`addResourceHandler`的参数是URL path patterns，`addResourceLocations`的参数是本地资源路径

@Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/")
                .setCacheControl(CacheControl.maxAge(0, TimeUnit.SECONDS)
                        .cachePublic());
    }

像这种的，就是将`src/main/resources/static`目录映射到/的url下

![aced83b2b09819882d02fd46f00b71dc.png][]

如果遇到问题，那么就debug ResourceHandlerRegistry的AbstractHandlerMapping getHandlerMapping()方法，在urlMap变量中看到url与handler的映射关系

#### 配置Last-Modified缓存 ####

@Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/")
                .setCacheControl(
                        CacheControl.maxAge(0, TimeUnit.SECONDS)
                        .cachePublic());
    }

如果遇到问题，那么就debug ResourceHandlerRegistry的`AbstractHandlerMapping getHandlerMapping()`方法，在urlMap变量中看到url与handler的映射关系

#### 配置Last-Modified缓存 ####

先一步一步的来，把`cacheControl`过期时间设置0，并设置为public，根据之前的流程图，因为过期时间为0，判断已过期，进入etag判断，而这里没有设置etag，那就进入`Last-Modified`判断。

需要注意的就是`no-cache`与`max-age=0`的区别，no-cache是压根都不用缓存，直接请求服务器200，过期时间为0就会走`Etag/Last-Modified`缓存的判断

![70699a28fe28155058bf3f9b9eb2dd28.png][]

发现已经变成了304，设置成功了。

![2b10f0b23d1b67bb88b129cd9723c797.png][]

现在就是通过对比`If-Modified-Since`和`Last-Modified`，就是文件修改时间来判断缓存的。

#### 配置ETag缓存 ####

@Bean
    public FilterRegistrationBean filterRegistrationBean () {
        ShallowEtagHeaderFilter eTagFilter = new ShallowEtagHeaderFilter();
        //设置为weakETag，默认为false
        // eTagFilter.setWriteWeakETag(true);
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(eTagFilter);
        registration.addUrlPatterns("/static/*");
        return registration;
    }

如果想开启Etag可以使用这个过滤器，把static下文件的设置上etag

这个过滤器是通过生成MD5值来校验的，也可以自定义一个生成Etag的规则

![05e6a01ad437198438e6fd6e92b92e35.png][]

第一次请求，服务器会返回一个Etag标签，200状态码

![2ce62db73229b14497e1dc8b19f3b298.png][]

第二次请求，浏览器携带这个etag带去后台验证，然后返回304

![2716c0675216a591b3b46da7b1e55e32.png][]

修改这个文件，发现返回了一个新的Etag，再次请求也是304，说明缓存成功了。另外，欢迎关注公众号Java笔记虾，后台回复“后端面试”，送你一份面试题宝典！

*（感谢阅读，希望对你所有帮助)*

*来源：blog.csdn.net/w57685321/article/details/92797551*

推荐好文

[强大，10k+点赞的 SpringBoot 后台管理系统竟然出了详细教程！][10k_ SpringBoot]

[分享一套基于SpringBoot和Vue的企业级中后台开源项目，代码很规范！][SpringBoot_Vue]

[能挣钱的，开源 SpringBoot 商城系统，功能超全，超漂亮][SpringBoot]![a7aea729911b43bf2e0dc310f817a320.png][]

[2818924ca41cc91e80be0aa005dc759f.png]: /images/20221004/c28177d26b9747c880911947b70590f9.png
[0b108affceb91a30c05b6af54370edfe.png]: /images/20221004/20b73205ac274025a62d56fadd75ba64.png
[7c06a7cfe00d2382255a4621b4c7e362.png]: /images/20221004/cecbd9c374c0484cbbe6982abbb963f2.png
[7c06a7cfe00d2382255a4621b4c7e362.png 1]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc798b9ecb0e0288697af194f241f3c3da73381f69116f72db3a0fdf92b6aa4e19dd3c5c285d&idx=3&mid=2247493168&scene=21&sn=4a2eb3c0ad574dd58bda8664746aae00#wechat_redirect
[358488d4371dbc70c5e81ff2e7c7623b.png]: /images/20221004/1e5954160c6347878d4003f4d82621d2.png
[db08307e6049fd47979b62e05e7e5289.png]: /images/20221004/8bc3d3d7eca04419b161397db9c33267.png
[9a9cf919c328db94427a4da1e28dd1aa.png]: /images/20221004/8baeff71970142d496a89198ebe2e171.png
[e57d904352f158e8a176a4739d567639.png]: /images/20221004/8acf8ffe73034819acd7a672932a4723.png
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc7a754ccb0dfc5ae5f35dba82b7c2137110817794a1daddb45845d0b19c194634f673d81531&idx=1&mid=2247489762&scene=21&sn=cfa544e27afedb00aeb54cb67e55ae74#wechat_redirect
[f1ef7f8b7d49558e21db5d6536f5d43a.png]: /images/20221004/849c36e521654976ab93bce3cad92f05.png
[7bc55c6b84a09d07bad9d1c39696cbf8.png]: https://img-blog.csdnimg.cn/img_convert/7bc55c6b84a09d07bad9d1c39696cbf8.png
[97875b1f9650ea76036207bb81926a49.png]: /images/20221004/55a6e1c6e0964d05b92c926cf0c57cd3.png
[97875b1f9650ea76036207bb81926a49.png 1]: http://mp.weixin.qq.com/s?__biz=MzI4Njc5NjM1NQ%3D%3D&chksm=ebd5ed45dca26453c0cf91265d669711a4e2b4ea52f3ff4a00b063a9de46d69fcc599f151210&idx=1&mid=2247504489&scene=21&sn=afd92248113146b086652ad7f89c7a7c#wechat_redirect
[3fb432ac0663dc1ad366d8d6663c44de.png]: /images/20221004/5d97b4337a684afc8db7d9d43cd955a6.png
[Spring boot]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc79a65bcb0e2f4d16ad217d5d89ff6d377cda9fa852746abe0d8de2543f984973400a8ade69&idx=1&mid=2247502837&scene=21&sn=96923ac65371557adf75fc3961b6c50c#wechat_redirect
[75048e96874cf621a5b4468ee7c0b2d7.png]: /images/20221004/a0eb76e9853e4cad82e9847b893d8034.png
[7b3fecc65f07b4d0e32c7c1e0b72ac97.png]: /images/20221004/d8b6d2dca29e46d590d9111f83fc2e70.png
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc79bbc3cb0e32d5e41f8aae90c81de6d7fba7bebd1637a02a757e46f5f95a2e50e6e3d88557&idx=2&mid=2247505517&scene=21&sn=5944a56e862c50b8351d5a44c043b82c#wechat_redirect
[e33de4869fdcec548f76bf74cf7e6d8c.png]: /images/20221004/bd0cabb14b984743bb18d62210af73cf.png
[a23730ab2f5a43088087da20d2b50bb4.png]: /images/20221004/fc763cc0fed5460487a18a9e4c7105b3.png
[aced83b2b09819882d02fd46f00b71dc.png]: /images/20221004/61928a1355894f96989a103b52f302de.png
[70699a28fe28155058bf3f9b9eb2dd28.png]: /images/20221004/8cf82da2e1ea48999650f7271766833b.png
[2b10f0b23d1b67bb88b129cd9723c797.png]: /images/20221004/481faa13288d4c06835887230d0fcaa8.png
[05e6a01ad437198438e6fd6e92b92e35.png]: /images/20221004/ff420725ab7d4de7807e115b6f7bd60e.png
[2ce62db73229b14497e1dc8b19f3b298.png]: /images/20221004/51f90bdcdd36466bab66ec4a89e6685b.png
[2716c0675216a591b3b46da7b1e55e32.png]: /images/20221004/3b391be018f640679558e28b73d8a020.png
[10k_ SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzI4Njc5NjM1NQ%3D%3D&chksm=ebd5c411dca24d07446a4f22772cd12d2cc1143b62eb922a14500ae981cd57fb850ef74ca257&idx=2&mid=2247498557&scene=21&sn=84902d7030e174e152615d8fae3755cc#wechat_redirect
[SpringBoot_Vue]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799be6cb0e12f0b58479f8b031bc5ae79efdca1880ff9b19f0a107c3a88c37b9596dc73203&idx=2&mid=2247497288&scene=21&sn=65d7111a19e920df1e9416959594b2f4#wechat_redirect
[SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799a9ccb0e138a64a2671f31b8d4be1b3c061a288f7b0d1d4af02a60c45a72231446b91e00&idx=2&mid=2247497522&scene=21&sn=c5b4e596be4ac7d7f293e7e2f0ea0769#wechat_redirect
[a7aea729911b43bf2e0dc310f817a320.png]: /images/20221004/6514ec5a3f634e89ad99e4bd67397dc2.png