在 nginx 中配置缓存有效期并配合 cache-control,核心在于使用 proxy_cache_valid 指令设置默认过期时间,并通过 add_header 或后端返回的响应头来覆盖或补充客户端和服务器的缓存策略。nginx 作为反向代理时,会优先遵循后端返回的 cache-control 指令(如 max-age),若未指定则使用 proxy_cache_valid 定义的规则。这种组合确保了浏览器和 cdn/边缘节点能正确缓存资源,同时 nginx 自身也能根据状态码管理上游缓存。

Nginx 如何根据 HTTP 状态码设置默认缓存时长
Nginx 通过 proxy_cache_valid 指令直接定义不同 HTTP 状态码对应的缓存有效期。该指令作用于 http、server 或 location 上下文,语法为 proxy_cache_valid [code ...] time;。例如,设置 200 302 10m 表示成功请求和重定向响应在 Nginx 缓存层保留 10 分钟。当后端没有返回明确的 Cache-Control 头部时,Nginx 将依据此配置决定缓存是否有效。这是构建基础缓存策略的第一步,确保静态或动态内容在源站更新前能被复用。

server {
listen 80;
server_name example.com;
# 定义缓存路径和参数
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
location /api/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
# 关键配置:根据状态码设置缓存时间
# 200 OK 缓存 10 分钟
# 404 Not Found 缓存 5 分钟
# 其他状态码不缓存
proxy_cache_valid 200 10m;
proxy_cache_valid 404 5m;
proxy_cache_valid any 0;
# 添加调试头,查看缓存命中情况
add_header X-Cache-Status $upstream_cache_status;
}
}
上述配置中,proxy_cache_valid 是控制 Nginx 内部缓存生命周期的关键。如果后端应用返回了 Cache-Control: no-cache,Nginx 默认不会缓存该响应,除非显式配置了 proxy_ignore_headers。因此,proxy_cache_valid 主要适用于后端未严格指定缓存策略或需要强制覆盖的场景。在实际部署中,建议先检查后端返回的头信息,再决定是否需要在此处硬编码过期时间。
如何处理后端 Cache-Control 与 Nginx 配置的冲突
当后端返回 Cache-Control 头部时,Nginx 的行为取决于 proxy_cache_control 指令的设置。默认情况下,Nginx 会尊重后端的 Cache-Control。如果希望 Nginx 忽略后端的缓存指令并使用自己的 proxy_cache_valid 设置,需启用 proxy_cache_control off;。此外,可以使用 add_header 在 Nginx 层面追加或修改响应头,但这通常用于向客户端展示信息,而非改变 Nginx 自身的缓存逻辑。解决冲突的最佳实践是明确后端职责:后端负责业务逻辑层面的缓存控制,Nginx 负责基础设施层面的缓存存储和失效。

server {
listen 80;
server_name example.com;
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m;
location /static/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
# 忽略后端的 Cache-Control 和 Expires
# 强制使用 Nginx 的 proxy_cache_valid 设置
proxy_cache_control off;
# 此时 Nginx 将完全依据下面的配置进行缓存
proxy_cache_valid 200 1h;
proxy_cache_valid 301 1d;
# 向客户端发送自定义的 Cache-Control
# 这会影响浏览器缓存,但不影响 Nginx 缓存行为(因为已关闭 proxy_cache_control)
add_header Cache-Control "public, max-age=3600";
}
}
在这个场景中,proxy_cache_control off; 是关键开关。它告诉 Nginx 不要解析后端返回的 Cache-Control 头部中的 max-age 或 s-maxage,从而避免后端短时效策略导致 Nginx 频繁回源。同时,add_header 用于向最终用户(浏览器)发送一个统一的缓存策略,确保前端体验一致。需要注意的是,add_header 仅在响应状态码不为 301、302 等重定向时生效,且如果后端已经设置了同名字段,Nginx 的 add_header 可能不会覆盖它,除非使用 always 参数或确保后端未设置。对于 API 接口,通常建议让后端控制 Cache-Control,Nginx 仅做透传或基于状态的简单缓存,以保持架构清晰。
如何验证 Nginx 缓存是否按预期生效
验证缓存生效最直接的方法是检查响应头中的 X-Cache-Status 字段。在 Nginx 配置中添加 add_header X-Cache-Status $upstream_cache_status; 后,每次请求都会返回当前状态:HIT 表示从 Nginx 缓存中直接读取,MISS 表示未命中并回源获取,EXPIRED 表示缓存过期并回源刷新,BYPASS 表示因配置原因跳过缓存。结合 curl -I 命令可以方便地观察这些状态变化。此外,可以通过监控 Nginx 缓存目录的文件大小和 inode 数量,评估缓存命中率及磁盘占用情况,确保缓存策略符合性能预期。











