最可靠的方式是直接压测并观察响应头。先清缓存后并发请求,首次返回MISS,第二次应为LOCKING或UPDATING,稍后应为HIT;压测时后端应仅收到1次请求,响应头需含X-Cache-Status与X-Cache-Lock,且需确认proxy_cache_lock on、key一致、无绕过规则。

直接压测 + 观察响应头是最可靠的方式。关键不是看配置有没有写对,而是看 Nginx 实际返回了什么状态、有多少请求真正打到了后端。
用 curl 快速验证锁是否生效
在缓存未命中(比如刚清空缓存或首次访问)时,并发发起两个紧邻请求:
- 先清缓存:
rm -rf /var/cache/nginx/proxy_cache/* && nginx -s reload - 第一次请求:
curl -I http://your-api.com/hot→ 应看到X-Cache-Status: MISS - 立刻再发一次:
curl -I http://your-api.com/hot→ 若锁生效,应看到X-Cache-Status: LOCKING或UPDATING(取决于是否已开启 background update) - 稍等 1–2 秒后再发:
curl -I http://your-api.com/hot→ 应返回X-Cache-Status: HIT
用 wrk 或 ab 做并发冲击测试
模拟真实高并发场景,确认锁是否能压住回源数量:
安装并运行 Aperture(Lightning Labs 的 L402 闪电反向代理),用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 启动压测:
wrk -c 100 -d 10s -t 4 http://your-api.com/hot(100 并发,持续 10 秒) - 同时在后端加日志或用
tcpdump -i lo port 8080统计实际收到的请求数 - 理想结果:后端只收到 1 次请求(首个 MISS),其余 99+ 请求全部命中缓存或等待锁
- 若后端收到几十次请求,说明 key 不一致、lock 未启用、或被
proxy_no_cache等规则绕过
检查关键响应头确认行为链路
在目标 location 中加上这两行,让每次响应都带诊断信息:
add_header X-Cache-Status $upstream_cache_status;add_header X-Cache-Lock $upstream_cache_lock;
压测后分析响应头分布:
-
X-Cache-Status: MISS→ 只应极少数(1~2 次),代表真正回源 -
X-Cache-Status: LOCKING或UPDATING→ 表示请求进入等待队列,锁正在起作用 -
X-Cache-Lock: 1→ 明确表示该请求触发了锁等待逻辑 - 大量
HIT+ 少量MISS+ 出现LOCKING→ 锁已正常工作
排除常见干扰项
如果始终看不到 LOCKING,大概率是基础条件没满足:
- 确认
proxy_cache_path在http块中已定义,且keys_zone名称与proxy_cache引用一致 - 确认目标
location中同时启用了:proxy_cache my_cache;和proxy_cache_lock on; - 检查是否误配了
proxy_no_cache、proxy_cache_bypass,或后端返回了Cache-Control: no-cache、Set-Cookie(需配合proxy_ignore_headers Set-Cookie) - 确认
proxy_cache_key是统一的,比如用"$scheme$host$uri"而非默认含$args的版本

















