JavaScript 中协商缓存怎么配合 Nginx 服务器配置

落磊姑娘_1426

落磊姑娘_1426

2026-08-16

647人浏览

原创

协商缓存由浏览器自动发起、Nginx 配合响应头实现,关键在于正确提供 ETag/Last-Modified 并响应 304;带哈希的 JS 文件应禁用协商缓存并启用 immutable 强缓存。

javascript 中协商缓存怎么配合 nginx 服务器配置

JavaScript 中的协商缓存本身不依赖前端代码主动设置,而是由浏览器自动发起、服务端(如 Nginx)配合响应头完成的。关键在于:Nginx 正确提供 ETag 或 Last-Modified,并在客户端携带 If-None-Match / If-Modified-Since 时返回 304。JavaScript 文件作为静态资源,其协商缓存行为完全由 Nginx 的响应头和客户端请求逻辑决定。

Nginx 默认已支持协商缓存,但需确认启用

Nginx 默认开启 etag on 和 if_modified_since exact,这意味着:

  • 对于文件系统中的真实静态文件(如 /static/app.js),Nginx 会自动生成 ETag(基于文件内容和修改时间的哈希)和 Last-Modified(基于文件 mtime)
  • 浏览器第二次请求时,若缓存未过期且未禁用,会自动带上 If-None-Match 或 If-Modified-Since
  • Nginx 内部比对后,匹配即返回 304 Not Modified,不传输 JS 内容,节省带宽与时间

无需额外配置即可生效,但建议显式确认:

location ~* \.js$ {
    etag on;
    if_modified_since exact;
    # 其他缓存头(可选)
    add_header Cache-Control "public, max-age=3600, must-revalidate";
}

⚠️ 注意:must-revalidate 表示缓存过期后必须验证,它不会阻止协商缓存,反而鼓励浏览器发起条件请求 —— 这正是 JS 文件(尤其未哈希命名时)需要的行为。

配合构建哈希的 JS 文件,应禁用协商缓存

如果 JS 文件已通过 Webpack/Vite 输出为带 contenthash 的路径(如 app.a1b2c3.js),则该文件内容不变时 URL 永远不变,适合强缓存:

location ~* \.[a-f0-9]{8,}\.js$ {
    add_header Cache-Control "public, max-age=31536000, immutable";
    etag off;  # 可选:immutable 已承诺永不变更,ETag 多余
}

此时 immutable 指令会让现代浏览器跳过所有条件请求(包括 If-None-Match),彻底避免协商开销 —— 这是性能最优解。

java后端编程
java后端编程

专用于 Java Spring Boot 后端开发的专业技能。当用户提出以下需求时,应调用此技能:构建 REST API、创建 Spring Boot 项目、编写 Java 后端服务、配置数据库访问(JPA / MyBatis)、处理认证与授权(Spring Security / JWT)、实现微服务架构(Spring Cloud)、排查 Spring Boot 相关错误、审查 Java 代码质量,或执行任何与 Spring Boot / Java 后端相关的任务。

下载

不要手动覆盖 ETag 或禁用协商缓存,除非有明确理由

以下做法通常有害:

  • etag off;:关闭 ETag 后,只剩 Last-Modified,而它的秒级精度在高频构建或 NFS 环境下易误判(内容未变但时间戳更新 → 返回 200)
  • add_header ETag "";:清空 ETag 会导致协商失败,浏览器退回到完整下载
  • 在 JS 响应中硬编码 Cache-Control: no-cache:强制每次走协商,失去 304 节省,还增加服务器压力

正确做法是让 Nginx 自动管理 ETag,仅通过 max-age + must-revalidate 控制协商时机。

验证 JS 文件是否走协商缓存

部署后务必检查实际响应:

  • 打开 Chrome DevTools → Network → 刷新页面
  • 找到一个 .js 请求 → 查看 Response Headers
    • 应有 ETag: "xyz..." 或 Last-Modified: ...
  • 第二次加载时,该请求状态码应为 304,Size 显示 (from memory cache) 或 (from disk cache)
  • 点开该请求 → Headers → Request Headers → 确认含 If-None-Match: "xyz..."

也可用命令行快速验证:

curl -I -H "If-None-Match: \"abc123\"" https://yoursite.com/app.js
# 若返回 304,说明协商正常;若返回 200,检查 ETag 是否一致、文件是否被覆盖等

不复杂但容易忽略

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5306

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1309

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5244

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1000

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1936

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3705

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4853

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3180

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

1008

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.3万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习