如何利用 proxy_cache_background_update 实现后端响应的后台异步刷新-Nginx-PHP中文网

proxy_cache_background_update 的作用是在缓存即将过期时，不阻塞用户请求，一边返回旧缓存一边后台更新；需配合 proxy_cache_valid、proxy_cache_use_stale updating 和 proxy_cache_background_update on 同时启用。

如何利用 proxy_cache_background_update 实现后端响应的后台异步刷新

proxy_cache_background_update 的作用不是“刷新缓存”，而是让 Nginx 在缓存即将过期时，**不阻塞用户请求**，一边把旧缓存返回给客户端，一边在后台悄悄去后端拉取新响应并更新缓存。它解决的是“缓存失效瞬间大量请求穿透到后端”的问题（即缓存雪崩/缓存击穿），而不是主动轮询或定时刷新。

启用 background update 的前提条件

这个功能不会自动生效，必须配合以下配置共同使用：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

proxy_cache_valid 必须设置明确的缓存有效期（例如 proxy_cache_valid 200 5m;）
proxy_cache_use_stale 必须启用至少一项“可接受过期缓存”的指令，比如 updating（关键！没有它，background update 不会触发）
proxy_cache_background_update on; 显式开启（默认是 off）

典型配置示例

以下是最小可行配置片段（放在 location 块中）：

proxy_cache my_cache;
proxy_cache_valid 200 5m;
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
proxy_cache_background_update on;
proxy_cache_lock on;  # 推荐搭配，避免重复回源

说明：
- 当一个请求命中缓存，且该缓存已存在 4m50s（即距离过期只剩 10s），Nginx 就会认为它“即将过期”；
- 如果此时有新请求进来，且缓存尚未完全过期，Nginx 会立即返回当前旧缓存（因为 updating 在 proxy_cache_use_stale 中）；
- 同时，Nginx 在后台发起一个异步子请求到后端，获取新响应，并用它更新缓存——整个过程对用户透明、无延迟。