如何通过if指令（慎用）配合变量实现对特定URL路径跳过缓存-Nginx-PHP中文网

推荐用 map 实现缓存绕过：在 http 块中定义 $skip_cache 变量匹配路径，再通过 proxy_cache_bypass 和 proxy_no_cache 引用；若必须用 if，仅限简单精确匹配且需配合 set，避免常见语法与逻辑错误。

如何通过if指令（慎用）配合变量实现对特定url路径跳过缓存

在 Nginx 中，可以通过 if 指令结合变量（如 $request_uri 或自定义变量）控制特定 URL 路径不走缓存，但需注意：if 在 location 块中行为受限，且过度使用易引发配置错误或性能问题。更推荐用 map 实现安全、高效的缓存绕过。

用 map 预定义跳过缓存的路径（推荐）

这是最稳妥的方式：先用 map 将匹配路径映射为一个布尔变量，再在 proxy_cache_bypass 和 proxy_no_cache 中引用。

示例配置：

# 在 http 块中定义
map $request_uri $skip_cache {
    ~^/api/v1/status     1;
    ~^/healthz           1;
    ~^/debug/            1;
    default              0;
}
<p>server {
location / {
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
proxy_cache my_cache;</p><pre class="brush:php;toolbar:false;">    # 当 $skip_cache 为非空/非0时，跳过缓存
    proxy_cache_bypass $skip_cache;
    proxy_no_cache     $skip_cache;
}

}

说明：

map 在请求处理早期执行，无副作用，性能好
~^ 表示大小写敏感正则匹配，/api/v1/status 和 /api/v1/status?x=1 都会命中
proxy_cache_bypass 让 Nginx 不查找缓存（直接转发）
proxy_no_cache 让 Nginx 不将响应写入缓存（防止脏数据写入）

若必须用 if（仅限简单精确匹配）

仅当路径是固定字符串、无查询参数、且你清楚风险时，可配合 set 变量在 location 内使用 if。

示例（不推荐但可行）：

location / {
    set $skip_cache 0;
<pre class="brush:php;toolbar:false;">if ($request_uri = "/healthz") {
    set $skip_cache 1;
}
if ($request_uri = "/readyz") {
    set $skip_cache 1;
}

proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
proxy_cache my_cache;
proxy_cache_bypass $skip_cache;
proxy_no_cache     $skip_cache;

}

注意：

if 在 location 中只支持有限指令（set、return、rewrite），不能直接写 proxy_cache_bypass
= 是精确字符串匹配，不支持正则；含查询参数的 URL（如 /healthz?ts=1）不会匹配
多个 if 是顺序执行，不是逻辑或，需显式覆盖

避免常见陷阱

以下做法容易出错，应规避：

在 if 块内直接写 proxy_cache_bypass 1 —— 语法错误，Nginx 不允许
用 if ($request_uri ~ /admin) 匹配子路径 —— if 在 location 中对正则的支持不稳定，可能失效
只设 proxy_cache_bypass 却漏掉 proxy_no_cache —— 后端返回的响应仍可能被缓存，下次请求即使 bypass 也可能命中旧缓存
把 map 写在 server 块内 —— 必须在 http 块顶层，否则报错