在 nginx 中,`proxy_cache_valid` 和 `expires` 共同生效的核心在于它们分别控制不同阶段的缓存行为:`proxy_cache_valid` 负责后端响应的存储时长(即 nginx 本地磁盘或内存中的缓存有效期),而 `expires` 负责向客户端浏览器发送 http 响应头,告知浏览器本地缓存的过期时间。要让两者配合良好,通常的做法是设置 `proxy_cache_valid` 为较长的时间以减轻后端压力,同时通过 `expires` 设置较短的时间或直接返回 `cache-control` 头来确保前端能及时感知内容更新,或者将两者设置为一致的值以实现端到端的统一缓存策略。

如何配置 proxy_cache_valid 以控制后端缓存
`proxy_cache_valid` 指令用于定义不同响应码的缓存有效期。它直接作用于 Nginx 的代理缓存区域(由 `proxy_cache_path` 定义)。当 Nginx 从后端获取到响应后,会根据该指令判断是否将该响应存入缓存以及存多久。例如,设置 `200` 和 `301` 响应码缓存 10 分钟,意味着在这 10 分钟内,如果有相同的请求到达,Nginx 会直接从本地缓存返回,不再向后端发起请求。

http {
# 定义缓存路径、级别和大小
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
# 关键配置:设置不同状态码的缓存时间
# 200 OK 缓存 10 分钟
# 301 Moved Permanently 缓存 1 小时
# 其他状态码不缓存
proxy_cache_valid 200 10m;
proxy_cache_valid 301 1h;
proxy_cache_valid any 0;
# 添加缓存键,确保 URL 不同则缓存不同
proxy_cache_key $scheme$request_method$host$request_uri;
}
}
}在上述配置中,`proxy_cache_valid` 明确指定了 `200` 状态码的响应将被缓存 10 分钟。这意味着对于 `/api/` 下的 GET 请求,如果后端返回 200,Nginx 会将该响应体存储在 `/var/cache/nginx` 目录下,并在接下来的 10 分钟内直接提供该缓存内容,除非缓存被手动清除或达到最大大小限制。这显著减少了向后端服务器的请求频率。
如何配置 expires 以控制客户端缓存
`expires` 指令用于在 Nginx 发送给客户端的 HTTP 响应头中添加 `Expires` 和 `Cache-Control` 字段。它告诉浏览器或其他 HTTP 客户端,该资源在本地可以缓存多久。与 `proxy_cache_valid` 不同,`expires` 不影响 Nginx 本身是否向后端请求数据,只影响客户端的行为。通常,为了配合后端缓存,我们会设置一个合理的客户端缓存时间,既减少带宽消耗,又保证用户能尽快看到更新。

server {
listen 80;
server_name example.com;
location /static/ {
root /usr/share/nginx/html;
# 设置静态资源客户端缓存时间为 1 天
expires 1d;
add_header Cache-Control "public, no-transform";
}
location /api/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_valid 200 10m;
proxy_cache_key $scheme$request_method$host$request_uri;
# 关键配置:设置 API 响应的客户端缓存头
# 这里我们让 Nginx 也向客户端发送 Cache-Control 头
# 注意:如果后端已经返回了 Cache-Control,proxy_cache_valid 不会覆盖它,
# 但我们可以用 add_header 强制添加或修改
add_header Cache-Control "public, max-age=600"; # 10 分钟
}
}在 `/api/` 位置块中,我们通过 `add_header` 添加了 `Cache-Control: public, max-age=600`。这与 `proxy_cache_valid 200 10m` 保持了一致性。当 Nginx 从后端获取到 200 响应并缓存 10 分钟后,它也会将这个 `Cache-Control` 头传递给客户端。客户端浏览器会在 10 分钟内直接使用本地缓存,而不会向 Nginx 发送请求。如果客户端缓存过期,它会向 Nginx 发送请求,此时 Nginx 检查自己的缓存,如果还在有效期内(10 分钟内),则直接返回缓存;如果超过 10 分钟,Nginx 会再次向后端请求最新数据,并更新本地缓存。这种配合确保了从客户端到 Nginx 再到后端的整个链路都有高效的缓存机制。
当后端返回不同的 Cache-Control 时如何处理
在实际开发中,后端应用可能会自己设置 `Cache-Control` 头。如果后端设置了 `no-cache` 或 `max-age=0`,而我们在 Nginx 中配置了 `proxy_cache_valid`,会发生什么?Nginx 的 `proxy_cache_valid` 指令有一个重要的特性:它尊重后端返回的 `Cache-Control` 和 `Expires` 头。如果后端返回 `Cache-Control: no-cache`,即使我们配置了 `proxy_cache_valid 200 10m`,Nginx 也不会缓存该响应,或者只会短暂缓存并立即验证。为了确保 Nginx 的缓存策略生效,我们需要使用 `proxy_ignore_headers` 指令来忽略后端的某些缓存相关头部,或者使用 `proxy_cache_control` 指令来重新解析。
location /api/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
# 忽略后端返回的 Cache-Control 和 Expires 头
# 这样 Nginx 就会完全依据 proxy_cache_valid 来决定是否缓存
proxy_ignore_headers Cache-Control Expires;
# 现在 proxy_cache_valid 将完全生效
proxy_cache_valid 200 10m;
proxy_cache_key $scheme$request_method$host$request_uri;
# 同时,我们可以强制设置发给客户端的 Cache-Control
add_header Cache-Control "public, max-age=600";
}在这个配置中,`proxy_ignore_headers Cache-Control Expires;` 是关键。它告诉 Nginx 不要理会后端服务器在响应中设置的 `Cache-Control` 和 `Expires` 头。这样一来,Nginx 就会完全按照 `proxy_cache_valid` 的配置来决定是否缓存响应。例如,即使后端说“不要缓存”,Nginx 依然会根据 `proxy_cache_valid 200 10m` 将其缓存 10 分钟。同时,`add_header Cache-Control


















