Nginx 的 map 指令可通过控制 proxy_cache_bypass 和 proxy_no_cache 实现缓存动态开关，支持按参数、UA、Cookie、URI、Content-Type 等条件精细化策略，并配合 cache_key 隔离不同设备缓存。
Nginx 的 map 指令本身不能直接开关 proxy_cache，但可以通过控制 proxy_cache_bypass 和 proxy_no_cache 这两个关键指令，实现对缓存启用/禁用的动态决策——这才是满足不同静态资源加速需求的实用路径。
核心逻辑是：让缓存“存在但不生效”或“生效但立即绕过”，比硬性关闭更灵活、更可控。
✅ 用 map 控制缓存是否真正写入与读取
proxy_cache_bypass 决定请求是否跳过缓存（即强制回源），proxy_no_cache 决定响应是否写入缓存。两者都支持变量，配合 map 可按需开启或屏蔽缓存。
常见业务场景映射示例：
- 请求带
?debug=1参数 → 不缓存 - User-Agent 包含
curl或httpie→ 不缓存（方便调试） - Cookie 中有
user_role=admin→ 不缓存（避免敏感内容误缓存） - URI 以
/static/开头且 Content-Type 是image/*→ 缓存 - URI 含
/api/→ 默认不缓存
配置写法（放在 http { } 块中）：
map $args $bypass_cache {
~*debug=1 "1";
default "0";
}
map $http_user_agent $bypass_by_ua {
~*curl|httpie "1";
default "0";
}
map $cookie_user_role $no_cache_for_role {
"admin" "1";
default "0";
}
map $request_uri $cache_switch {
~^/static/ "on";
~^/api/ "off";
default "on";
}
在 location 中联动使用：
location / {
proxy_pass http://backend;
proxy_cache my_cache;
proxy_cache_valid 200 302 1h;
# 任一为 "1" 就绕过缓存（即不读缓存）
proxy_cache_bypass $bypass_cache $bypass_by_ua $no_cache_for_role;
# 任一为 "1" 就不写缓存（即不存响应）
proxy_no_cache $bypass_cache $bypass_by_ua $no_cache_for_role;
# 可选：仅对 /static/ 路径启用缓存，其他一律 bypass
proxy_cache_bypass $cache_switch;
proxy_no_cache $cache_switch;
}
⚠️ 注意：
proxy_cache_bypass和proxy_no_cache是“真值判断”——只要变量值非空且不等于0、off、false、no，就视为开启 bypass/no_cache。
✅ 按资源类型精细化开关缓存（如 JS/CSS 缓存、HTML 不缓存）
利用 $sent_http_content_type（上游返回的 Content-Type）做后端响应驱动的缓存策略：
map $sent_http_content_type $should_cache {
~*^text/css "on";
~*^application/javascript "on";
~*^image/ "on";
~*^text/html "off"; # HTML 动态内容通常不缓存
default "off";
}
location / {
proxy_pass http://backend;
proxy_cache my_cache;
# 只有 $should_cache == "on" 时才允许缓存该响应
proxy_no_cache $should_cache;
proxy_cache_bypass $should_cache;
# 同时设一个基础缓存时间，配合变量生效
proxy_cache_valid 200 302 10m;
}
✅ 提示：要使
$sent_http_content_type可用，必须确保proxy_buffering on;（默认开启），且上游确实返回了Content-Type头。
✅ 配合 cache_key 实现“逻辑隔离”，避免开关混乱
单纯开关缓存可能引发冲突，比如 PC 和移动端共用 URL 却返回不同 HTML。此时应让 proxy_cache_key 包含设备标识：
map $http_user_agent $device {
~*Mobile|Android|iPhone "mobile";
default "desktop";
}
# 在 location 中
proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args$device";
这样即使都启用缓存，PC 和移动版也互不影响，开关策略更安全。
不复杂但容易忽略
