在 nginx 中配置缓存失效与回源配合,核心在于利用 proxy_cache_valid 设置不同 http 状态码的缓存时长,并通过 proxy_cache_key 确保请求标识的唯一性。当客户端请求带有 cache-control: no-cache 或 pragma: no-cache 头时,nginx 会忽略本地缓存并直接向后端发起回源请求,从而保证获取最新数据。

如何根据响应状态码设置不同的缓存有效期
通过 proxy_cache_valid 指令可以精确控制哪些状态的响应被缓存以及缓存多久。例如,将 200 和 301 响应缓存 10 分钟,而 404 响应仅缓存 1 分钟,这样既减少了无效请求对后端的压力,又避免了错误页面长期驻留。

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 / {
proxy_pass http://backend;
proxy_cache my_cache;
# 设置缓存键,包含查询参数以确保资源唯一性
proxy_cache_key "$scheme$request_method$host$request_uri";
# 配置缓存失效策略:200/301缓存10分钟,404缓存1分钟
proxy_cache_valid 200 301 10m;
proxy_cache_valid 404 1m;
# 允许客户端通过请求头强制刷新
proxy_cache_bypass $http_cache_control;
}
}
上述配置中,proxy_cache_path 定义了磁盘缓存的位置和基本参数,keys_zone 用于在共享内存中存储缓存键的元数据。当后端返回 200 OK 时,Nginx 会将响应体存入磁盘并记录元数据,有效期为 10 分钟。若后端返回 404 Not Found,则仅缓存 1 分钟,防止频繁请求同一不存在资源。这种基于状态码的差异化管理是优化缓存命中率的关键。
如何处理客户端强制刷新导致的回源行为
当用户点击浏览器刷新按钮或前端代码发送带 no-cache 头的请求时,Nginx 应跳过本地缓存直接回源。这通过 proxy_cache_bypass 指令实现,它检查特定变量(如 $http_cache_control)的值,若匹配则不使用缓存。

# 测试场景:模拟带 no-cache 头的请求 curl -H "Cache-Control: no-cache" http://example.com/api/data # 预期结果:Nginx 不读取本地缓存,直接向 backend 发起请求 # 后端返回新数据,Nginx 更新缓存并返回给客户端 # 测试场景:普通请求(无特殊头) curl http://example.com/api/data # 预期结果:若缓存未过期,直接返回本地缓存;否则回源
在实际部署中,前端应用常通过 JavaScript 动态添加 Cache-Control: no-cache 头以触发强制刷新。Nginx 接收到此类请求后,proxy_cache_bypass 检测到该头部存在,便不会从 my_cache 中查找命中项,而是直接将请求转发至 backend。这种方式确保了关键接口数据的实时性,同时不影响其他静态资源的缓存效率。
当后端返回 500 错误时缓存是否生效
默认情况下,Nginx 不会对 5xx 服务器错误进行缓存,因为这类响应通常表示临时故障,缓存错误内容可能导致用户体验恶化。若需缓存特定错误页,必须显式使用 proxy_cache_valid 指定 500 状态码及其有效期。
在标准配置中,若后端返回 500 Internal Server Error,Nginx 不会将其存入缓存目录,而是直接透传给客户端。这意味着后续相同请求仍会触发回源,可能加剧后端负载。若业务要求缓存错误页(如展示自定义维护页面),可添加如下配置:proxy_cache_valid 500 5m;。此时,500 响应将被缓存 5 分钟,期间相同请求直接返回缓存的错误页,减轻后端压力。但需注意,这仅适用于错误页内容固定且非敏感的场景。


















