如何通过proxy_ignore_headers强制接管后端的轮询缓存行为-Nginx-PHP中文网

nginx 无“轮询缓存”机制，所谓轮询失效实为后端响应头不一致导致缓存键分裂与策略冲突；应通过 proxy_ignore_headers 忽略干扰头、proxy_cache_valid 统一时长、proxy_cache_key 锁定键值三步闭环接管缓存决策权。

如何通过proxy_ignore_headers强制接管后端的轮询缓存行为

proxy_ignore_headers 本身不处理“轮询缓存行为”——Nginx 没有叫“轮询缓存”的原生机制。你实际想解决的，是后端在多个实例间因响应头不一致导致缓存命中率低、cache key 分裂、或缓存策略被随机覆盖的问题。典型表现是：相同请求反复 MISS，X-Cache-Status 不稳定，缓存目录下出现大量相似但未复用的 key。

要真正“强制接管”，核心不是轮询，而是统一缓存决策权：让 Nginx 忽略后端各自返回的干扰头，再用本地规则（如 proxy_cache_valid + 稳定 proxy_cache_key）主导缓存生命周期与键值生成。

明确哪些响应头在制造“伪轮询”效果

后端集群各节点若独立设置响应头，会导致 Nginx 认为它们是不同资源：

Vary 头不一致：比如 A 节点返回 Vary: User-Agent，B 节点返回 Vary: Accept-Encoding，Nginx 会为每个组合生成独立 cache key，造成碎片化
Cache-Control 或 Expires 时间微差：A 返回 max-age=3599，B 返回 max-age=3600，虽仅差1秒，但 proxy_cache_valid 若未覆盖，Nginx 可能按上游最短时间执行，导致提前失效
Set-Cookie 随机存在：某节点埋点逻辑偶发写入 Set-Cookie: _gid=xxx，另一节点不写 → Nginx 默认对带该头的响应完全不缓存，造成部分请求永远 MISS

这些现象看起来像“轮询失效”，实则是缓存判定逻辑被上游打乱。

正确接管方式：三步闭环配置

关掉上游干扰头的影响

在启用缓存的 location 块中，紧邻 proxy_pass 之前写：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

proxy_ignore_headers Cache-Control Expires Vary Set-Cookie;

大小写敏感，空格分隔，不可换行
它不删除头，只让 Nginx 在判断是否缓存、缓多久、用哪个 key 存时“假装看不见”

用 `proxy_cache_valid` 主导缓存时长

必须显式声明，否则忽略后 Nginx 不会自动缓存：

proxy_cache_valid 200 302 1h;
proxy_cache_valid 404 1m;

所有 200/302 响应统一缓存 1 小时，不再受后端 max-age=0 或 Expires: Thu, 01 Jan 1970 干扰
404 单独设短周期，防错误页长期污染缓存

锁定 cache key，消除碎片化

默认 key 包含 $scheme$proxy_host$request_uri，但若后端因 UA 或编码差异返回不同 Vary，你已忽略它，就更要确保 key 不随请求头漂移：

proxy_cache_key "$scheme$host$request_uri";
# 或更严格（排除无关参数）
proxy_cache_key "$scheme$host$uri$is_args$arg_id$arg_type";

避免用 $http_user_agent 或 $http_accept_encoding —— 即使你忽略了 Vary，key 里再引入它们，等于白忽略
若接口本就不依赖参数（如 /api/status），可简化为 "$uri"

必须同步做的安全与可用性防护

隐藏不该透传的头
proxy_ignore_headers Set-Cookie; 只让 Nginx 缓存它，但响应仍会把 Cookie 发给客户端。务必加：
```
proxy_hide_header Set-Cookie;
```
禁用可能引发冲突的选项
proxy_cache_use_stale updating; 在后台更新时可能返回旧缓存，若后端 Cookie 不一致，易导致状态错乱，建议关闭或谨慎启用。
验证是否真接管成功
用同一 URL 发两次 curl -I：
- 首次 X-Cache-Status: MISS，第二次 HIT → 缓存已生效
- 响应头中仍有 Cache-Control: no-cache（说明 proxy_ignore_headers 起作用）
- 但已无 Set-Cookie（说明 proxy_hide_header 生效）
- 查看 /var/cache/nginx/ 下对应 key 文件的 mtime 是否在第二次请求后未刷新（证明未回源）