在 nginx 中，`proxy_cache_background_update` 通过开启后台线程机制实现异步更新。当缓存文件过期时，nginx 会立即返回旧的缓存内容给客户端，同时在后台启动一个新的请求去获取最新的资源并替换旧文件。这一过程由 `proxy_cache_background_update on;` 指令控制，配合 `proxy_cache_lock` 防止并发回源，确保高并发下的缓存一致性。
如何配置 proxy_cache_background_update 和 proxy_cache_lock
要实现该功能，必须在 `http` 或 `server` 块中启用 `proxy_cache_background_update`，并建议同时开启 `proxy_cache_lock` 以避免多个请求同时回源。配置时需指定 `proxy_cache_path` 目录，并确保 Nginx 版本支持该特性（通常 1.17.0+）。这样配置后，过期的缓存不会阻塞用户请求，而是直接响应旧数据。
worker_processes auto;
events {
worker_connections 1024;
}
http {
# 定义缓存路径
proxy_cache_path /tmp/nginx_cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_server;
# 启用缓存
proxy_cache my_cache;
# 设置缓存有效期为 10 秒，用于演示过期
proxy_cache_valid 200 10s;
# 核心配置：开启后台异步更新
proxy_cache_background_update on;
# 防止缓存击穿：同一 key 只有一个请求回源
proxy_cache_lock on;
# 允许返回过期的缓存内容
proxy_cache_use_stale updating;
}
}
}
上述配置中，`proxy_cache_valid 200 10s` 将成功响应的缓存时间设为 10 秒。当请求到达时，如果缓存存在且未过期，直接返回。如果缓存存在但已过期，且开启了 `proxy_cache_background_update on`，Nginx 会检查 `proxy_cache_lock`。若锁空闲，则发起新请求更新缓存，同时向客户端返回旧的 stale 缓存。若锁被占用，其他请求也会等待或直接返回 stale 缓存（取决于 `proxy_cache_use_stale` 设置）。
proxy_cache_background_update 与 proxy_cache_lock 的交互逻辑
这两个指令共同作用以平衡性能与一致性。`proxy_cache_background_update` 负责“异步”，即不阻塞主进程；`proxy_cache_lock` 负责“串行化”回源请求。如果没有 `proxy_cache_lock`，多个过期请求可能同时触发后台更新，导致后端压力激增。开启 `proxy_cache_lock` 后，只有第一个请求会触发后台更新，后续请求会等待锁释放或直接使用现有缓存。这种组合确保了在高并发场景下，既保证了用户体验（低延迟），又保护了后端服务。
# 模拟测试脚本 test.sh curl -v http://example.com/api/data && sleep 15 && curl -v http://example.com/api/data
在实际测试中，第一次请求会正常获取数据并缓存。等待超过 10 秒后再次请求，此时缓存已过期。由于开启了异步更新，第二次请求会立即返回上一次缓存的数据（状态码 200，但实际是 stale 内容），同时 Nginx 在后台静默地向后端发起新请求。新请求完成后，缓存文件会被更新。通过观察 Nginx 错误日志，可以看到 `cache background update` 相关的记录，证实了异步行为的发生。
基于 proxy_cache_use_stale updating 的具体行为分析
当 `proxy_cache_background_update on` 生效时，Nginx 默认会尝试返回过期的缓存内容。这依赖于 `proxy_cache_use_stale` 中的 `updating` 参数。如果未显式设置 `proxy_cache_use_stale`，Nginx 在某些版本或配置下可能不会自动返回 stale 内容，从而导致请求失败或等待后台更新完成。因此，明确配置 `proxy_cache_use_stale updating` 是关键步骤。它告诉 Nginx：当缓存正在后台更新时，允许使用旧的缓存响应客户端。如果不加此配置，即使开启了异步更新，客户端也可能面临短暂的 502 或超时错误，因为 Nginx 不知道是否应该提供旧数据。
