map指令不直接用于location匹配，而是将请求特征映射为变量，再通过if或proxy_pass等间接影响路由；它支持正则匹配、多级组合与动态头控制，但须注意作用域限制与执行时机。
在 Nginx 中，
指令本身不“生成变量”用于 Location 匹配，但它能将请求特征（如 URI、Host、Header）映射为自定义变量值，再通过
或
等指令间接影响匹配行为——这是简化复杂 Location 逻辑的核心技巧。
用 map 提前归类请求特征，替代大量重复 location 块
当需按 URI 前缀、文件类型、API 版本等做不同处理时，直接写多个
或
易冗余且难维护。改用
将共性提取为变量，再统一用一个 location 处理：
在
块中定义映射关系，例如区分静态资源与动态接口：
在
块中用单个
+
分支判断（注意：
在 location 内是安全的）：
这样避免了写 5–6 个相似的
，逻辑集中、易读易调。
结合正则捕获组 + map 实现动态后端路由
若需从 URI 中提取 ID、租户名等并转发到对应后端，
可配合
、
使用（需先用
或
预处理，因
不支持直接捕获）：
Nginx
在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。
下载
先用
提取关键字段到变量（在
或
中）：
再用
组合决策（如 fallback 到默认集群）：
最后统一代理：
规避常见陷阱：map 的作用域与执行时机
是在请求初始化阶段执行的，仅支持
块；它不能引用其他变量的运行时结果（如
在
中可用，但
若由
动态赋值，则可能为空）：
确保被映射的源变量（如
、
）是 Nginx 内置且稳定可用的
避免在
中依赖
、
生成的变量——它们执行晚于
不支持嵌套或条件嵌套，复杂逻辑建议拆成多层 map 或用 Lua（OpenResty）补充
进阶：用 map 控制缓存策略与响应头
根据请求特征动态设置
、
或重定向规则，无需为每个路径单独配置：
示例：对含
查询参数的静态资源启用强缓存，其余设为 no-cache：
这种写法比用
更轻量，且 map 查找是 O(1) 哈希匹配，性能更优。
mapiftry_fileslocation ^~location ~maphttpmap $uri $resource_type {
~*\.(js|css|png|jpg|gif|woff2?)$ static;
~*^/api/v1/ api_v1;
~*^/api/v2/ api_v2;
default app;
}serverlocation /ififlocation / {
if ($resource_type = static) {
expires 1y;
add_header Cache-Control "public, immutable";
break;
}
if ($resource_type = api_v1) {
proxy_pass http://backend_v1;
break;
}
if ($resource_type = api_v2) {
proxy_pass http://backend_v2;
break;
}
# 默认走主应用
proxy_pass http://app_backend;
}locationmaprewritesetmaprewriteserverlocationset $tenant "";
set $service "";
if ($host ~ "^([a-z0-9\-]+)\.example\.com$") {
set $tenant $1;
}
if ($uri ~ "^/svc/([a-z0-9\-]+)/") {
set $service $1;
}mapmap "$tenant:$service" $upstream_backend {
"prod:auth" auth-prod;
"staging:auth" auth-staging;
"prod:billing" billing-prod;
default default_backend;
}location /svc/ {
proxy_pass http://$upstream_backend;
}maphttp$arg_xmap$my_varset$uri$hostmapsetrewritemapmapCache-ControlContent-Typev=xxxmap $args $cache_policy {
~v=[a-f0-9]{8,} "public, max-age=31536000, immutable";
default "no-cache, must-revalidate";
}
# 在 location 中直接使用：
add_header Cache-Control $cache_policy;if ($args ~ v=)