灰度测试中需用proxy_cache_bypass和proxy_no_cache配合，使灰度流量绕过读缓存并禁止写入缓存，再通过map统一灰度标识、扩展cache_key或隔离缓存区，确保灰度响应不污染主缓存。
要通过 proxy_cache_bypass 在灰度测试中验证缓存行为，核心不是“清缓存”，而是让灰度流量**可控地绕过读缓存、强制回源**，同时确保其响应不污染主缓存区——这样既能观察新逻辑的真实输出，又不影响线上用户命中率和数据一致性。
灰度标识需统一映射为 Nginx 可识别的变量
灰度通常靠请求头（如 X-Env: gray）、Cookie（如 version=gray）或 query 参数（如 ?v=gray）区分。Nginx 不直接识别这些原始标识，必须转为变量：
-
X-Env: gray→ 对应变量$http_x_env（短横变下划线，全小写） -
Cookie: version=gray→ 对应变量$cookie_version -
?v=gray→ 对应变量$arg_v
推荐优先用请求头，语义清晰且不易被客户端随意修改；若必须用 Cookie，注意 $cookie_* 变量在未携带时值为空字符串，不会误触发。
用 map 指令做灰度判定，提升可维护性
避免在 location 中堆砌复杂条件判断，用 map 提前计算是否属于灰度流量：
map $http_x_env $is_gray {
"gray" 1;
default 0;
}
map $cookie_version $is_gray_cookie {
"gray" 1;
default 0;
}
# 合并多个来源：任一为 1 即进入灰度
map $is_gray $skip_cache {
1 "1";
0 "";
}
map $is_gray_cookie $skip_cache {
1 "1";
"" $skip_cache; # fallback 到上一个 map 结果
}
这样后续所有缓存控制逻辑都只依赖 $skip_cache，增删灰度维度只需改 map，不碰转发逻辑。
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
绕过 + 隔离：bypass 和 no_cache 必须成对使用
灰度请求既要跳过旧缓存，又不能把调试响应存进去（比如带临时日志、未脱敏字段、或仅对灰度生效的格式），所以必须同时配置：
-
proxy_cache_bypass $skip_cache;→ 值为非空即绕过读缓存 -
proxy_no_cache $skip_cache;→ 值为非空则禁止将本次响应写入缓存
二者变量名一致，逻辑才闭环。漏掉 proxy_no_cache，灰度请求回源拿到的响应可能被缓存下来，下次普通用户请求恰好命中，导致数据泄露或格式错乱。
缓存 key 要兼容灰度语义，避免交叉污染
如果灰度逻辑改变了后端响应内容（如加字段、改结构），但 proxy_cache_key 还是默认的 $scheme$request_method$host$request_uri，就会出现“灰度请求更新了缓存，普通用户拿到灰度版响应”的事故。
安全做法是让 key 显式包含灰度标识：
- 按环境区分：
proxy_cache_key "$scheme$request_method$host$request_uri$is_gray"; - 按版本号区分：
proxy_cache_key "$scheme$request_method$host$request_uri$cookie_version"; - 更稳妥：灰度走独立缓存区（如
proxy_cache gray_cache;），彻底物理隔离
验证时可对比不同 key 的缓存命中状态：灰度请求返回 X-Cache-Status: BYP，普通请求仍为 HIT，说明隔离有效。
