在 nginx 中配置缓存有效期并实现批量调整,核心在于使用 location 块配合 expires 指令。通过正则表达式匹配文件后缀(如 .jpg、.css),可以为不同资源类型设置不同的过期时间,例如将静态图片设为长期缓存,而 html 页面设为不缓存。

如何为特定后缀的静态资源设置长期缓存
针对图片、CSS 和 JS 等静态资源,通常希望浏览器缓存较长时间以减少服务器请求。可以使用 location ~* \.ext$ 语法匹配特定扩展名,并在其中设置 expires 参数。例如,将所有 .png 和 .jpg 文件的缓存时间设置为 30 天。

server {
listen 80;
server_name example.com;
# 匹配所有 png 和 jpg 图片,设置 30 天缓存
location ~* \.(png|jpg)$ {
root /var/www/html/images;
expires 30d;
add_header Cache-Control "public";
}
# 匹配所有 css 和 js 文件,设置 7 天缓存
location ~* \.(css|js)$ {
root /var/www/html/static;
expires 7d;
add_header Cache-Control "public";
}
location / {
root /var/www/html;
index index.html;
}
}
上述配置中,expires 30d 会生成 Expires 和 Cache-Control: max-age=2592000 响应头。客户端在 30 天内再次访问相同 URL 时,若未失效则直接使用本地缓存。注意 root 路径需与实际文件存储位置一致,且 add_header 用于显式声明缓存策略,增强兼容性。
如何批量排除动态接口或 HTML 页面的缓存
对于 API 接口或动态生成的 HTML 页面,通常不希望被浏览器缓存,以确保数据实时性。可以通过 location 匹配通用路径或使用 if 判断,设置 expires off 或 Cache-Control: no-cache。例如,对所有以 /api/ 开头的请求禁用缓存。

server {
listen 80;
server_name example.com;
# 禁止 /api/ 下所有资源的缓存
location /api/ {
proxy_pass http://backend_server;
expires off;
add_header Cache-Control "no-cache, no-store, must-revalidate";
add_header Pragma "no-cache";
add_header Expires "0";
}
# 默认 HTML 页面也不缓存
location ~* \.html$ {
root /var/www/html;
expires -1;
add_header Cache-Control "no-store";
}
location / {
root /var/www/html;
index index.html;
}
}
这里 expires off 清除默认的过期时间,配合 Cache-Control: no-store 确保浏览器和中间代理不存储任何副本。对于 HTML 文件,expires -1 表示立即过期,适用于需要频繁更新的页面内容。这种配置可避免用户看到过时的界面或错误数据。
当静态资源文件名包含版本号时缓存策略如何生效
在实际项目中,静态资源常通过文件名哈希(如 app.v1.2.3.js)实现版本控制。此时,只要文件名不变,缓存即可长期生效;一旦内容更新导致文件名变化,浏览器会请求新文件。Nginx 的 expires 对带哈希的文件同样适用,无需额外配置。
# 假设文件结构如下:
# /var/www/html/static/app.v1.2.3.js
# /var/www/html/static/style.v4.5.6.css
location ~* \.(css|js)$ {
root /var/www/html/static;
expires 365d; # 长期缓存,依赖文件名变更触发刷新
add_header Cache-Control "public, immutable";
}
添加 immutable 标记可告知浏览器该资源在有效期内不会改变,进一步优化加载性能。此策略依赖于构建工具在每次发布时生成唯一文件名,确保旧缓存不会被误用。若文件名不含版本标识,则需缩短缓存时间或引入查询参数区分版本。











