Nginx缓存策略配置错误（如proxy_cache_bypass值非法、if中误用add_header、Host头与upstream不匹配）会导致502 Bad Gateway，需用nginx -t验证语法，并通过curl或CDN日志确认绕过是否生效。
缓存策略本身不会直接触发 502，但配置中语法错误或逻辑冲突会让 Nginx 在转发请求时“找不到路”或“不敢发”，最终返回 502 Bad Gateway。这类问题常被误判为后端挂了，其实根源在代理层的缓存指令写错了。
检查 proxy_cache_bypass 和 proxy_no_cache 的值是否合法
这两个指令只接受 0/1 布尔值 或 变量表达式（如 $arg_nocache），不能写字符串字面量：
- ❌ 错误写法：
proxy_cache_bypass "1";或proxy_cache_bypass $cookie_auth "0";—— 双引号包裹的字符串无法参与布尔判断，Nginx 会静默忽略该行或 reload 失败 - ✅ 正确写法：
proxy_cache_bypass $arg_nocache $cookie_admin;（多个变量用空格分隔） - ✅ 验证方式：
nginx -t必须通过；若 reload 后出错，先看它是否报语法问题
避免在 if 块里用 add_header 控制缓存绕过
很多人想实现“带 ?force=1 就不走缓存”，于是这样写：
if ($arg_force = "1") { add_header Cache-Control "no-cache"; }
这在语法上合法，但Nginx 不允许在 if 中使用 add_header，该指令会被忽略，且可能干扰后续 proxy_pass 行为，导致 upstream 解析失败。
✅ 推荐做法：用 map 提前定义绕过变量，再统一控制
- 在 http 块中添加：
map $arg_force $skip_cache { default 0; "1" 1; } - 在 location 中写：
proxy_cache_bypass $skip_cache;
确认 proxy_set_header Host 是否匹配 upstream 名称
缓存绕过常伴随 Host 头重写，比如：
proxy_set_header Host "api.internal";
但如果 upstream 块里没有名为 api.internal 的 server，Nginx 就无法解析目标地址，直接返回 502 —— 日志里通常显示 no live upstreams 或 upstream resolver timeout。
- 检查 upstream 定义：
upstream api.internal { server 127.0.0.1:8000; } - 或者改用 IP+端口直连，避免依赖名称解析：
proxy_pass http://127.0.0.1:8000;
验证 CDN 或网关层缓存绕过是否真生效
有些 502 实际是“缓存里存了个旧的 502 页面”，不是实时错误。需确认绕过规则是否真正触发：
- 用 curl 对比：
curl -I https://example.com/api?nocache=1和curl -I https://example.com/api - 看响应头：
绕过成功应有X-Cache: BYPASS或X-Cache-Status: MISS；
若仍是HIT，说明规则没匹配上（比如路径漏了/、正则大小写敏感） - CDN 控制台查执行日志，确认规则命中次数和动作是否为 “Bypass”
