如何配置 expires 指令为静态文件设置缓存期

<p>在Nginx中为静态文件设置浏览器缓存需精准匹配资源、分类型设定过期时间并补全Cache-Control头：用location ~* .(js|css|png|jpg|gif|woff2|svg)$或location ^~ /static/匹配，带哈希文件设expires 1y并加public, immutable, max-age=31536000；图片字体设expires 30d及public, max-age=2592000；HTML等动态内容用expires epoch和no-cache, must-revalidate, max-age=0；配置后须nginx -t校验、curl -I验证响应头、浏览器Network确认304或缓存加载。</p>

直接在 Nginx 的 location 块里用 expires 指令，就能为静态文件设置浏览器缓存时间。核心是匹配准确、策略合理、响应头完整。

匹配静态资源要精准

别用模糊规则，避免误缓存 HTML 或接口响应：

• 用 ~* 不区分大小写匹配后缀：比如 location ~* .(js|css|png|jpg|gif|woff2|svg)$
• 用 ^~ 前缀匹配静态目录：比如 location ^~ /static/，性能更高且更安全
• 绝对不要写 location / { expires 1d; } 或 location ~ .html$，否则 HTML 页面可能被长期缓存

按资源类型设不同过期时间

缓存时长得看文件是否带版本标识（如哈希名），不是越长越好：

• 带哈希的 JS/CSS（如 app.a1b2c3.js）：设 expires 1y; 或 expires max;
• 图片、字体、图标等稳定资源：设 expires 30d; 或 expires 6m;
• 未做版本控制的通用资源（如 logo.png）：建议 expires 1h;～expires 1d;
• HTML、PHP、JSON 等动态内容：用 expires epoch;（立即过期）或 expires -1;

必须补全 Cache-Control 头

expires 只生成基础缓存头，现代浏览器更依赖 Cache-Control，需手动补充：

• 对带哈希资源：加 add_header Cache-Control "public, immutable, max-age=31536000";
• 对普通图片：加 add_header Cache-Control "public, max-age=2592000";
• 对 HTML：加 add_header Cache-Control "no-cache, must-revalidate, max-age=0";
• 注意：add_header 同级多次声明会覆盖，务必合并成一条

配置后一定要验证

改完不能直接上线，得确认响应头真实生效：

• 先运行 nginx -t 检查语法是否正确
• 再执行 nginx -s reload 重载配置
• 用 curl -I https://your-site/style.css 查看响应头，确认同时存在 Expires 和 Cache-Control
• 打开浏览器开发者工具 → Network → 刷新资源，检查状态码是否为 304（协商缓存生效）或直接从 memory/disk cache 加载