Nginx的map指令不支持真正动态变量，但可通过正则捕获、多层映射、变量拼接和空值显式处理等方式模拟动态条件判断，实现高性能、稳定的请求路由与逻辑分支。
Nginx 的 map 指令本身不支持“动态变量”（比如运行时拼接字符串、调用函数或嵌套逻辑），但它可以通过多层映射、正则匹配、默认值回退和组合变量等方式，**模拟出接近动态条件判断的效果**。关键在于把复杂逻辑拆解为可预测的输入→输出映射，并利用 Nginx 变量的求值时机和作用域特性。
用正则 + 分组提取实现“动态”路径解析
比如你想根据请求路径 /api/v1/users/123 提取版本号 v1 或用户 ID 123，再据此设置不同 upstream：
map $request_uri $api_version {
~^/api/(?<ver>v\d+)/ $ver;
default "v1";
}
<p>map $request_uri $user_id {
~^/api/v\d+/users/(?<id>\d+) $id;
default "";
}说明：
- $request_uri 是原始完整路径（含 query string），适合做正则提取；
- (?<ver>v\d+) 是命名捕获组，Nginx 会自动将匹配内容赋给变量 $ver，并在 map 中直接引用；
- 多个 map 块可并行定义，彼此独立，最终变量可在 server 或 location 中使用。
用嵌套 map 实现多级条件判断（类似 if-else if-else）
单个 map 只支持线性匹配，但你可以用“中间变量”串联多个 map，实现优先级控制。例如：先按域名分大类，再按路径细分行为：
# 第一层：按 host 分组
map $host $service_group {
~^api\.(.*)$ "api";
~^admin\.(.*)$ "admin";
default "web";
}
<h1>第二层：针对 api 组进一步判断 path</h1><p>map "$service_group:$request_uri" $backend {
~^api:/health "health_upstream";
~^api:/v1/ "v1_upstream";
~^api:/v2/ "v2_upstream";
~^admin:/ "admin_upstream";
default "default_upstream";
}说明：
- 将两个变量拼成一个新键（如 "api:/v1/users"），利用字符串前缀匹配实现“组合条件”；
- 注意双引号包裹拼接表达式，防止空格或特殊字符出错；
- 正则中 ^api: 确保只匹配以 api: 开头的键，避免误匹配 myapi:。
结合内置变量与默认值处理边界情况
真实场景中，变量可能为空或未定义（如 $arg_token 不存在时是空字符串）。map 默认不会触发 default 分支，除非显式匹配空值：
map $arg_token $auth_level {
"" "guest";
"~^t_[a-f0-9]{8}" "user";
"~^a_[a-f0-9]{8}" "admin";
default "guest";
}
<h1>更稳妥写法：显式检查空/未定义</h1><p>map $arg_token $auth_level_safe {
"" "guest";
"~^.+$" $auth_level; # 复用上面的逻辑，但确保非空才走正则
default "guest";
}说明：
- "" 明确匹配空字符串（即参数缺失或值为空）；
- "~^.+$" 匹配任意非空字符串，再跳转到另一个 map 或直接赋值；
- 避免依赖 default 覆盖所有异常，主动控制空值更可靠。
在 server 或 location 中安全使用 map 变量
map 定义的变量只能在 http 块中声明，且**仅在请求处理阶段求值**（不是配置加载时）。使用时注意：
- 不能在
map块内部引用另一个 map 变量（会报错 “variable is not allowed here”）； - 可在
set、proxy_pass、return、add_header等指令中直接使用，如：proxy_pass http://$backend;； - 若需在
if中判断，建议改用map先转成布尔标记（如$is_v2 = "1"），因为if在 location 中有陷阱； - 调试技巧：用
add_header X-Debug-Backend "$backend";把变量值返回响应头，方便验证逻辑。
本质上，Nginx 的 map 是静态映射表，所谓“动态”是靠设计输入键（如拼接、正则提取）和分层结构来逼近需求。只要输入可枚举、规则可描述，就完全能替代大部分 if-else 场景，而且性能更高、更稳定。
