Java 如何确保 JS 不被缓存

大家好，我是 V 哥。今天咱们来聊一聊 Java 后端确保 JavaScript 不被缓存的问题，先来了解一下为什么需要这样做，通常源于以下几种场景或问题：

1. 先来看几个问题

1. 文件更新后无法及时生效

浏览器缓存机制是为了加快加载速度和减少服务器压力，但有时会带来问题。当 JavaScript 文件更新后，如果浏览器从缓存中加载旧版本，用户就无法看到最新的功能或修复的 Bug。举个例子：开发者发布了新版本的前端代码，修复了一个关键问题，但用户的浏览器仍然使用缓存的旧代码，导致问题依然存在。用户可能以为网站没修复或出现新问题，从而影响用户体验。

2. 前后端不一致

在 Java Web 应用中，JavaScript 通常用于与后端服务交互。如果 JavaScript 代码版本和后端逻辑不一致，可能导致不兼容问题。举个例子：后端接口的请求格式发生变化，但浏览器仍然使用旧的 JavaScript 代码，结果是客户端与服务器之间通信失败，产生错误。

3. 影响调试与开发

在开发和调试环境中，缓存会导致代码变更后无法即时看到效果，这对于调试过程非常不便。开发者可能会在调试中发现修改的代码没有被应用，导致浪费时间。举个例子：开发者修改了 JavaScript 文件，但由于缓存，浏览器继续执行旧的代码，开发者无法验证新代码是否正确，甚至可能以为代码本身有问题。

4. 安全问题

旧的缓存可能会暴露系统之前存在的漏洞。即使后端做了升级，修复了安全漏洞，但如果浏览器加载了旧的 JavaScript 文件，可能仍然会受到攻击。举个例子：假设某个版本的 JavaScript 中存在一个 XSS 漏洞。虽然新版本已经修复了这个漏洞，但浏览器缓存的旧文件仍然暴露在攻击风险中。

所以，如果前端页面无法及时响应更新（如修复 Bug、优化功能等），用户体验可能会受到负面影响。特别是在进行产品版本迭代时，缓存问题可能会使新功能看起来未上线，影响用户的使用体验和满意度。

2. 那要如何解决呢？

在 Java Web 开发中，为了确保 JavaScript 文件（或任何静态资源）不被浏览器缓存，可以使用以下几种经验：

1. 使用版本号或时间戳

为 JavaScript 文件的 URL 添加一个版本号或时间戳，使得每次文件更新后 URL 不同，这样浏览器会认为是新的资源，从而重新加载。比如：

<script src="app.js?v=1.0.1"></script>

或者使用动态的时间戳：

<script src="app.js?t=<%= System.currentTimeMillis() %>"></script>

通过这种方式，每次生成不同的查询参数，浏览器会认为这是一个新的文件，不会从缓存中读取。

2. 设置 HTTP 响应头

在 Java 后端（比如 Spring Boot 或 Servlet），可以通过设置 HTTP 头来控制缓存。常见的 HTTP 头包括：

Cache-Control: 控制缓存行为。
Pragma: 控制缓存行为（主要用于兼容 HTTP/1.0）。
Expires: 设置资源过期的时间。

示例代码（Spring Boot 过滤器）：

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletException;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

import javax.servlet.http.HttpServletResponse;

import java.io.IOException;

public class NoCacheFilter implements Filter {

    @Override

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)

        throws IOException, ServletException {

        HttpServletResponse httpResponse = (HttpServletResponse) response;

        httpResponse.setHeader("Cache-Control", "no-store, no-cache, must-revalidate, max-age=0");

        httpResponse.setHeader("Pragma", "no-cache");

        httpResponse.setHeader("Expires", "0");

        chain.doFilter(request, response);

    }

    @Override

    public void init(FilterConfig filterConfig) throws ServletException {}

    @Override

    public void destroy() {}

}

3. 配置静态资源的缓存策略

在 Spring Boot 项目中，可以通过配置类来定义静态资源的缓存策略。例如：

import org.springframework.context.annotation.Configuration;

import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;

import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration

public class WebConfig implements WebMvcConfigurer {

    @Override

    public void addResourceHandlers(ResourceHandlerRegistry registry) {

        registry.addResourceHandler("/js/**")

                .addResourceLocations("classpath:/static/js/")

                .setCachePeriod(0); // 0 表示不缓存

    }

}

通过 setCachePeriod(0) 设置缓存周期为 0，强制浏览器每次都从服务器获取最新的 JavaScript 文件。

4. 使用 `ETag` 或 `Last-Modified`

在 HTTP 响应中设置 ETag 或 Last-Modified，这样浏览器在每次请求时都会询问服务器资源是否更新。如果没有变化，服务器会返回 304 状态码，从而避免不必要的重新加载。

示例（设置 Last-Modified）：

httpResponse.setDateHeader("Last-Modified", System.currentTimeMillis());

上面的几种方法，能确保浏览器及时获取最新版本的 JavaScript 文件，不使用缓存的旧版本。

关于一些思考

问题来了，那什么时候可以使用缓存？

虽然缓存可能带来这些问题，但并不意味着缓存永远不好。在某些场景中，使用浏览器缓存可以显著提升性能：

静态资源（如 JavaScript、CSS 文件）较少更改时，缓存可以显著减少网络请求，提升页面加载速度。
确保在更新时有效控制缓存机制（比如用文件的版本号或哈希值作为文件名的一部分）可以避免不必要的重新下载和过度加载。

如何平衡？

通常，咱们不会完全禁止缓存，而是通过版本号、哈希、缓存控制头等方式来平衡性能和更新问题。这样，浏览器在没有必要时可以利用缓存，而在需要时也能获取最新的资源。关注威哥爱编程，码码通畅不掉发。