自动异步更新需 proxy_cache_background_update on、proxy_cache_use_stale updating 和 proxy_cache_valid 三者缺一不可,配合稳定 cache key 与 proxy_cache_lock 防并发,后端需识别 X-Updating: 1 跳过非核心逻辑。

缓存失效时“自动异步更新”不是靠单个指令实现的,而是由 proxy_cache_background_update 触发、配合多项关键配置协同生效的一套容灾机制。它的核心目标不是让内容永远新鲜,而是让用户在缓存过期瞬间完全不感知延迟——旧内容毫秒返回,新内容后台静默生成。
必须配齐的三项基础配置
只加 proxy_cache_background_update on; 没有效果,以下三者缺一不可:
-
启用 stale 回退策略:加上
proxy_cache_use_stale updating;,告诉 Nginx “缓存正在更新时,允许继续用旧缓存响应”。这是用户不卡顿的前提; -
明确定义缓存有效期:例如
proxy_cache_valid 200 302 10s;。没有有效期,Nginx 就无法判断是否过期,整个机制无法启动; -
确保 cache key 稳定可复现:使用如
proxy_cache_key "$scheme$host$request_uri";。若 key 中含随机参数、时间戳或 Cookie,后台刷新请求算出的 key 和前台不一致,新内容会写错位置,导致更新失败。
推荐搭配 proxy_cache_lock 防并发回源
高并发下多个请求同时命中同一过期缓存,可能触发大量后台请求,拖垮后端。建议开启锁控制节奏:
-
proxy_cache_lock on;:保证同一 key 只有一个请求真正回源; -
proxy_cache_lock_timeout 5s;:超时后不再等待,直接走 stale 路径返回旧内容; - 可选加
proxy_cache_lock_age 15s;:锁释放后 15 秒内禁止新更新,防止抖动。
后端需轻量配合(尤其对 API)
Nginx 后台刷新请求会携带 X-Updating: 1(PHP 中为 $_SERVER['HTTP_X_UPDATING']),后端应据此跳过非核心逻辑:
- 检查该 header 是否为 "1",若是,则跳过审计日志、消息通知、权限二次校验等耗时操作;
- 但数据查询、模板渲染、JSON 组装等核心输出流程必须完整执行——否则缓存写入的是空或错误响应;
- 避免依赖 session 或用户态数据生成缓存内容,防止缓存污染。
验证是否真正生效
加一行调试头:add_header X-Cache-Status $upstream_cache_status;
- 首次访问 → 响应头中出现
X-Cache-Status: MISS,随后变为HIT(说明缓存已写入); - 等待缓存过期后再次访问 → 仍见
HIT,且响应时间极低(说明 stale + background update 已接管); - 同时观察后端日志:应能看到一次带
X-Updating: 1的后台请求,且仅一次。











