缓存不生效通常是因为 nginx 没有正确识别响应头中的 cache-control 或 expires,或者请求的 url 参数导致缓存键冲突。要解决这个问题,需要在 proxy_cache_path 中配置 proxy_cache_key,并在 location 块中使用 proxy_cache_valid 设置默认过期时间,同时通过 add_header 强制覆盖客户端的缓存指令。

如何忽略客户端的 Cache-Control 指令
当后端服务器返回 no-cache 或 private 时,Nginx 默认会尊重这些指令而不进行缓存。解决方法是在 location 块中添加 proxy_ignore_headers 指令,告诉 Nginx 忽略后端的 Cache-Control 和 Vary 头部,从而统一由 Nginx 控制缓存策略。

如何处理带参数的 URL 缓存冲突
如果 URL 中包含查询参数(如 ?id=1),默认的缓存键会将参数视为路径的一部分,导致每个参数组合都生成一个新的缓存文件。可以通过修改 proxy_cache_key 为仅包含 $uri 或使用正则表达式过滤掉特定参数,确保相同资源的不同参数请求共享同一个缓存对象。

验证 proxy_cache_valid 对 404 状态的处理
在配置了 proxy_cache_valid 后,需要确认 Nginx 是否会对后端返回的 404 错误进行缓存。默认情况下,proxy_cache_valid 不会缓存 404 状态码,除非显式指定。这可以防止将不存在的资源长期缓存,避免用户一直看到错误的页面。
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 use_temp_path=off;
location /api/ {
# 忽略后端的 Cache-Control 和 Vary 头
proxy_ignore_headers Cache-Control Vary;
# 设置缓存键,仅使用 URI,忽略查询参数
proxy_cache_key "$scheme$request_method$host$request_uri";
# 设置缓存有效期:200 状态码缓存 10 分钟,404 缓存 1 分钟
proxy_cache_valid 200 10m;
proxy_cache_valid 404 1m;
# 添加自定义头部显示缓存命中情况
add_header X-Cache-Status $upstream_cache_status;
# 代理指向后端服务
proxy_pass http://backend_server;
}
}
上述配置中,proxy_cache_valid 200 10m 表示成功响应缓存 10 分钟。proxy_cache_valid 404 1m 表示 404 错误缓存 1 分钟。如果未显式指定 404,则默认不缓存。通过 X-Cache-Status 头部可以观察缓存命中状态:HIT 表示命中缓存,MISS 表示未命中,EXPIRED 表示缓存已过期。











