proxy_cache_background_update是纯后台异步刷新机制：nginx返回过期缓存的同时异步更新，需配齐四支柱——启用proxy_cache_use_stale updating、设置proxy_cache_valid有效期、开启proxy_cache_lock防击穿、确保proxy_cache_key与proxy_cache_path keys_zone一致。

`proxy_cache_background_update` 本身不是“异步同步”，它是一个**纯后台异步刷新机制**——Nginx 在返回过期缓存内容的同时，悄悄发起一个不阻塞用户响应的子请求去更新缓存。所谓“异步同步”容易引发误解，实际配置目标是：**让旧内容秒回（异步响应），新内容后台静默拉取（异步更新）**，二者完全解耦。 要让它真正工作，关键不是调参数，而是配齐四根支柱：

必须启用 stale 响应授权

这是启动整个机制的开关。没有它，Nginx 遇到过期缓存会直接卡住等回源，根本不会返回旧内容，后台更新也就无从谈起：

• 一定要包含 updating：`proxy_cache_use_stale updating`
• 建议补全容错项：error timeout http_500 http_502 http_503 http_504
• 写法示例：proxy_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;

必须定义明确的缓存有效期

没有过期时间，就没有“过期后是否能用旧内容”的判断依据：

FastAPI Flask Proxy

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

下载

• 为常见状态码设有效期，例如：proxy_cache_valid 200 302 30s;
• API 类接口建议 10s～2m；带哈希的静态资源可设 1h+
• 务必单独控制 404：proxy_cache_valid 404 10s;，避免无效缓存长期占位

必须开启缓存锁防并发击穿

多个请求同时命中同一过期 key，若不加锁，可能瞬间触发几十次后台回源，反而压垮上游：

• proxy_cache_lock on; —— 只允许一个请求真正回源
• proxy_cache_lock_timeout 5s; —— 锁等待超时后，直接走 stale 返回旧内容
• 可选加固：proxy_cache_lock_age 15s;，锁释放后 15 秒内禁止重复更新

必须保障缓存基础稳定

后台子请求要能复用原有缓存项，依赖 key 和存储路径一致：

• proxy_cache_path 中 keys_zone 名称 必须与 location 中 proxy_cache 值严格匹配
• proxy_cache_key 推荐用：$scheme$host$request_uri$is_args$args
• 避免混入易变字段（如时间戳、未过滤 cookie、随机数）
• 确认后端能接受无认证的后台子请求（不带敏感 header 或 session）