开发环境用 X-Dev-Bypass: 1 请求头可实时回源调试，需在同 location 中配置 proxy_cache、proxy_cache_bypass $http_x_dev_bypass 和 proxy_no_cache $http_x_dev_bypass，并设置合理 cache_key 与 X-Cache-Status 响应头验证。
在开发环境中用 proxy_cache_bypass 做实时回源调试，核心是让本地或测试请求“跳过 Nginx 缓存，直连后端服务”，同时不干扰其他环境、不修改后端代码、也不需重启 Nginx。关键在于用可控制的触发条件（如自定义 Header 或 URL 参数），配合精准的 location 配置。
开发环境专用 bypass 触发方式
推荐使用带明确语义的请求头，比如 X-Dev-Bypass: 1，避免与生产环境冲突：
- Nginx 自动将请求头
X-Dev-Bypass映射为变量$http_x_dev_bypass（注意短横变下划线、全小写） - 只要该变量值非空且不等于
"0"、"off"，就触发 bypass - 开发时用
curl -H "X-Dev-Bypass: 1" http://localhost/api/user即可立即回源 - 前端调试可在 fetch 请求中加 headers: { 'X-Dev-Bypass': '1' }，需后端允许该 header（CORS 配置中加
Access-Control-Allow-Headers）
开发配置必须包含的三要素
仅写 proxy_cache_bypass 不生效——它必须和缓存机制共存于同一 location：
-
启用缓存区：确保有
proxy_cache my_dev_cache;（即使只用于开发，也得声明） -
绑定 bypass 条件：写在同一个 location 内，如
proxy_cache_bypass $http_x_dev_bypass; -
禁用响应缓存（重要）：开发中常返回敏感或临时数据，应加
proxy_no_cache $http_x_dev_bypass;，防止把调试响应误存进缓存
避免开发调试污染缓存 key
开发时若带 cookie、token 或动态参数，而 proxy_cache_key 没包含它们，会导致不同请求命中同一缓存条目（缓存污染）：
- 建议开发环境 cache_key 简洁但安全，例如：
proxy_cache_key "$scheme$request_method$host$request_uri"; - 若需区分用户，可加入
$cookie_session_id或$arg_token，但要确认这些变量在开发中稳定可用 - 调试期间可临时加
add_header X-Cache-Status $upstream_cache_status;，响应头看到BYP表示已绕过
本地联调验证技巧
不用等部署，直接在本地 Nginx + 后端服务组合中验证是否生效：
- 发起两次请求：一次不带
X-Dev-Bypass（应返回 HIT 或 MISS），一次带（应返回 BYP） - 检查 Nginx access 日志中的
$upstream_cache_status字段，对比是否从HIT变为BYP - 后端加简单日志，如打印 “Received dev-bypass request”，确认请求确实抵达后端
- 浏览器开发者工具 → Network → 查看响应头是否有
X-Cache-Status: BYP
