调优 proxy_cache_lock_timeout 的核心目标是平衡及时返回缓存与避免长时间空等，超时后等待请求各自回源；合理值为3–8秒，需配合 proxy_cache_valid 降低 miss 率，并启用 proxy_cache_use_stale 兜底。
调优 proxy_cache_lock_timeout 的核心目标，是让等待请求在“及时返回缓存”和“避免长时间空等”之间取得平衡——它不决定是否锁住请求，而是决定等多久后放弃等待、转而各自回源。
明确 timeout 的触发边界与实际行为
该参数只在以下条件下起作用：
- 请求命中 cache miss（缓存未命中或已过期）
-
proxy_cache_lock on已启用，且首个请求正在回源 - 后续请求进入等待队列，尚未获得响应
一旦超时，Nginx 不会返回错误，而是让等待中的请求**各自发起新的后端请求**——此时击穿风险重现。因此 timeout 不是“保护阈值”，而是“容忍延迟上限”。
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
设为 3–8 秒是多数场景的合理区间
这个范围兼顾了后端响应稳定性与用户体验：
- 若后端平均回源耗时约 1–2 秒（如静态资源、轻量 API），设
5s可覆盖绝大多数等待场景，极少触发并发回源 - 若后端偶有抖动（如磁盘 IO 延迟、DB 查询慢），
8s可减少 timeout 导致的二次穿透 - 低于
3s容易在后端稍慢时就释放等待队列，多个请求几乎同时回源，失去 lock 意义
配合 proxy_cache_valid 缩减 miss 频次，降低 timeout 压力
timeout 调优效果高度依赖 miss 率。miss 越少，lock 竞争越弱，timeout 设得再保守也影响不大：
- 对图片、JS/CSS 等静态资源，建议
proxy_cache_valid 200 302 24h或更长 - 对带版本号的资源（如
app.js?v=2.3.1），用proxy_cache_key "$scheme$host$request_uri"显式剔除$args，避免同一文件因参数不同生成多个 key - 避免将时间戳类参数（
?t=1713086520）纳入 key，否则每个请求都是独立锁，timeout 形同虚设
必须同步启用 stale 回退，兜底 timeout 失效场景
仅靠 timeout 控制无法应对后端失败或长期卡顿。应搭配：
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;- 当首个请求回源失败或超时，等待中的请求可立即返回旧缓存（即使已过期），而非全部 fallback 到新回源
- 这相当于把“等待锁 → 回源”路径，降级为“等待锁 → 返回 stale → 后台异步刷新”，大幅缓解源站压力
