Web 服务器与网关 / 系统课时
控制缓存绕过与过期回源
控制缓存绕过与过期回源
本篇介绍如何精细控制 Nginx 缓存是否读取、是否写入以及缓存失效后的回源行为。完成配置后,可以避免登录用户命中公共缓存,并减少热点资源同时回源造成的压力。
学习目标
- 理解 cache_bypass、no_cache 与 stale 相关指令的作用区别
- 配置缓存绕过和缓存锁,控制高并发下的回源行为
- 掌握通过响应头验证缓存策略是否生效
理解缓存控制链路
Nginx 缓存处理通常包含读取缓存、判断是否绕过、决定是否写入三个阶段。cache_bypass 控制是否从缓存读取,no_cache 控制响应是否保存到缓存,两者经常组合使用。
例如,登录用户携带 Cookie 时,通常应该跳过公共缓存,同时避免把个性化响应写入缓存。

配置缓存绕过规则
在站点配置中,可以根据请求条件决定是否使用缓存。下面示例让带有 session_id Cookie 的请求直接回源,并禁止该响应进入缓存。
nginx
location /api/ {
proxy_cache app_cache;
proxy_cache_bypass $skip_cache;
proxy_no_cache $skip_cache;
proxy_cache_valid 200 10m;
proxy_pass http://backend;
}
map $http_cookie $skip_cache {
default 0;
~*session_id 1;
}预期结果
text
带 session_id Cookie 的请求:跳过缓存并回源
普通请求:读取缓存并按规则保存响应处理过期缓存与上游异常
缓存过期后,Nginx 默认会重新请求上游获取最新内容。对于短暂故障,可以使用 stale 策略继续返回旧缓存,降低用户受影响范围。
nginx
location /static/ {
proxy_cache app_cache;
proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504;
proxy_pass http://backend;
}预期结果
text
上游正常:返回最新响应
上游 502/503:优先返回已有缓存内容防止热点失效击穿
大量请求同时访问刚过期的热点数据时,可能产生缓存击穿。proxy_cache_lock 可以让一个请求负责回源,其余请求等待缓存更新。
nginx
location /hot-data {
proxy_cache app_cache;
proxy_cache_lock on;
proxy_cache_lock_timeout <TIME>s;
proxy_pass http://backend;
}预期结果
text
同一时间大量请求:一个请求访问上游,其余请求等待缓存生成按自己的节奏,确认真正理解。