必须配合proxy_ignore_headers忽略cache-control、expires、set-cookie、vary等干扰头，再由proxy_cache_valid显式设定缓存时间，否则后端错误头会直接否决缓存规则。

要让 Nginx 缓存真正按你设定的时间生效，不能只靠 proxy_cache_valid，必须配合 proxy_ignore_headers 把后端乱写的缓存控制头“挡在门外”——否则那些 Cache-Control: no-cache 或 Expires: 1970-01-01 会直接否决你的缓存规则。

为什么 proxy_cache_valid 单独不生效

Nginx 默认优先信任上游响应头。哪怕你写了 proxy_cache_valid 200 1h;，只要后端返回：

• Cache-Control: no-cache 或 max-age=0
• Expires: Thu, 01 Jan 1970 00:00:00 GMT
• Set-Cookie: tracking_id=abc

Nginx 就会跳过缓存，连 proxy_cache_valid 都没机会执行。这不是配置错了，是它根本没走到那一步。

proxy_ignore_headers 必须忽略哪些头

这四个头最常干扰缓存决策，需按需组合忽略：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

• Cache-Control：屏蔽 no-cache、private、no-store 等指令
• Expires：绕过错误的绝对过期时间（大小写敏感，必须写成 Expires）
• Set-Cookie：Nginx 默认拒缓存带此头的响应，确认内容无用户态数据后可忽略
• Vary：避免因 Vary: User-Agent 等导致缓存碎片化

多个头用空格分隔：proxy_ignore_headers Cache-Control Expires Set-Cookie Vary;

必须配套的缓存指令

忽略只是“松绑”，不是“自动缓存”。你还得明确告诉 Nginx 怎么缓：

• 启用缓存区：proxy_cache my_cache;（需提前在 http 块中定义 proxy_cache_path）
• 指定状态码与有效期：proxy_cache_valid 200 302 1h;（别漏掉 302，重定向也值得缓）
• 错误页单独控制：proxy_cache_valid 404 1m;（防雪崩）
• 防止透传干扰：proxy_hide_header Cache-Control; 和 proxy_hide_header Set-Cookie;
• 主动声明客户端缓存：add_header Cache-Control "public, max-age=3600" always;

配置位置和顺序很关键

这个指令只在启用缓存的 location 块中有效，且必须：

• 写在 proxy_pass 之后、proxy_cache 相关指令之前
• 不能放在 http 或 server 全局块里
• 大小写严格匹配，不加引号、不加逗号

正确示例：

location /static/ {
  proxy_pass http://backend;
  proxy_ignore_headers Cache-Control Expires Set-Cookie;
  proxy_cache my_cache;
  proxy_cache_valid 200 302 1y;
  proxy_hide_header Cache-Control;
  add_header Cache-Control "public, immutable, max-age=31536000" always;
}