在 nginx 中配置静态资源长缓存,核心做法是在 `location` 块中使用 `expires` 指令设置过期时间。例如,将图片、css 和 js 文件的缓存有效期设置为一年(`1y`),浏览器在有效期内会直接使用本地副本而不发起网络请求,从而显著提升加载速度并减少服务器负载。

如何针对不同类型的静态文件设置不同的缓存策略
可以通过正则表达式匹配文件后缀,为 HTML 文件和媒体文件应用不同的缓存时长。HTML 文件通常建议设置较短的缓存或禁止缓存,以确保用户能获取最新的页面结构;而图片和视频等二进制资源则适合长期缓存。

server {
listen 80;
server_name example.com;
# HTML 文件:不缓存,每次检查
location ~* \.html$ {
expires -1;
add_header Cache-Control "no-cache, no-store, must-revalidate";
}
# 图片和媒体文件:长缓存 1 年
location ~* \.(jpg|jpeg|png|gif|ico|css|js|mp4|webm)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
}
上述配置中,`expires -1` 配合 `Cache-Control: no-cache` 确保 HTML 始终从服务器验证;而 `expires 1y` 配合 `immutable` 告诉浏览器该资源在未来一年内不会改变,无需重新验证。这种组合能有效利用浏览器缓存机制。
如何处理缓存更新时的版本冲突问题
当静态资源内容更新时,由于文件名未变,浏览器仍会使用旧的缓存副本。解决此问题的标准做法是使用文件名哈希(如 MD5)或版本号作为查询参数,使新版本的资源拥有唯一的 URL,从而绕过旧缓存。

# 假设构建工具生成的文件名如下:
# style.a1b2c3d4.css
# app.e5f6g7h8.js
location ~* \.(css|js)$ {
# 即使文件内容改变,只要文件名变了,URL就不同
# Nginx 直接提供新文件,浏览器视为新资源
expires 1y;
access_log off;
}
在实际部署中,前端构建工具(如 Webpack 或 Vite)会在编译时为文件名添加内容哈希。Nginx 只需按原样提供这些带哈希的文件即可。由于 URL 唯一性,旧缓存自然失效,无需复杂的缓存清除逻辑。这种方法比使用 `Cache-Control: no-cache` 更高效,因为它避免了不必要的 HTTP 请求。
基于 Nginx 日志中 304 状态码的具体问题分析
如果观察到大量 304 Not Modified 响应,说明客户端正在发送条件请求(如 `If-None-Match` 或 `If-Modified-Since`)。这通常发生在未设置 `immutable` 或未使用哈希文件名的场景下。对于已设置长缓存且内容不变的资源,304 是正常现象,表明协商缓存生效。但若希望完全避免 304 请求以提升性能,应结合文件名哈希和 `immutable` 标志,使浏览器直接返回本地副本而不向服务器发送任何请求。











