在 nginx 中设置静态资源缓存,核心做法是在 location 块中配置 expires 指令并配合 add_header 添加 cache-control 响应头。通过指定时间(如 1y)或相对时间,nginx 会自动生成标准的 http 缓存控制头,浏览器据此决定是否向服务器发起请求。若需针对特定文件类型(如图片、css)应用不同策略,只需为对应的 location 分别设置即可。

如何为不同类型的静态资源设置不同的缓存策略
针对不同后缀的文件设置差异化缓存,最直接的方法是利用 location 的路径匹配规则。例如,将 HTML 文件设置为不缓存,而将 CSS、JS 和图片设置为长期缓存。这样既保证了页面内容的实时性,又充分利用了浏览器缓存加速资源加载。

server {
listen 80;
server_name example.com;
# HTML 文件:不缓存,每次检查
location ~ \.html$ {
root /var/www/html;
expires -1;
add_header Cache-Control "no-cache, no-store, must-revalidate";
}
# CSS/JS 文件:缓存一年
location ~* \.(css|js)$ {
root /var/www/static;
expires 1y;
add_header Cache-Control "public, immutable";
}
# 图片文件:缓存一个月
location ~* \.(jpg|jpeg|png|gif|ico)$ {
root /var/www/images;
expires 30d;
add_header Cache-Control "public";
}
}
上述配置中,expires -1 等同于禁用缓存,强制浏览器每次请求都去服务器验证。对于 CSS 和 JS,使用 immutable 标志告诉浏览器内容永远不会改变,只要文件名不变就不需要重新验证。图片缓存 30 天,适合变化频率较低的资源。实际运行时,浏览器会先读取本地缓存,若未过期则直接使用,不再发送 HTTP 请求,从而显著提升加载速度。
如何在缓存失效时实现平滑过渡而不产生 404
当静态资源更新导致旧缓存失效时,直接替换文件可能导致部分用户请求到正在写入中的新文件,引发 500 错误。解决此问题的标准做法是使用“原子替换”策略:先将新文件保存为临时名称,再通过 mv 命令重命名为正式文件名。由于 Linux 文件系统中原子重命名操作极快,Nginx 几乎不会读到不完整文件。同时,配合 try_files 或 error_page 可以进一步确保请求的稳定性。

# 部署脚本示例 (伪代码)
cp new_style.css /tmp/style.css.tmp
mv /tmp/style.css.tmp /var/www/static/style.css
# Nginx 配置片段
location ~* \.css$ {
root /var/www/static;
expires 1y;
# 如果文件不存在,尝试返回默认样式或错误页
try_files $uri =404;
}
这种机制确保了即使在高并发场景下,用户也只会看到完整的旧文件或完整的新文件,不会出现混合内容。结合版本化文件名(如 style.v2.css),可以彻底避免缓存污染问题,因为旧文件不会被删除,新文件拥有唯一标识,浏览器会根据 URL 变化自动获取最新资源。
当浏览器强制刷新时 Nginx 如何处理缓存头
当用户按下 F5 或 Ctrl+F5 强制刷新时,浏览器行为因操作系统和浏览器类型而异。Chrome 在 Windows 上通常发送 If-None-Match 或 If-Modified-Since 条件请求,而在 macOS 上可能完全忽略缓存。Nginx 默认行为是:若客户端发送了条件请求且资源未修改,返回 304 Not Modified;若资源已修改,返回 200 OK 及新内容。对于强缓存(如 expires 1y),浏览器在未过期前通常不会发送任何请求,除非强制刷新。
为了更精细地控制这一过程,可以结合 etag 和 last_modified。Nginx 默认开启 etag,基于文件 inode 和大小生成哈希。若希望减少服务器负载,可关闭 etag 仅依赖 last_modified,但需注意秒级精度可能导致误判。在实际开发中,建议保留默认的 etag 设置,因为它能更准确地检测微小变更,且现代浏览器对 304 响应的处理非常高效,网络开销极小。


















