nginx 的 map 指令用于变量映射而非直接路径匹配，需结合 try_files、alias 或 root 实现静态资源动态分发；通过正则捕获请求特征（如子域名、uri 版本号）映射为路径变量，在 location 中引用该变量并配合 alias（替换匹配部分）或 root（追加 uri）定位资源；map 必须定义在 http 块内，仅支持字符串映射，调试建议开启 error_log 并打印变量验证。
Nginx 的 map 指令本身不直接匹配路径，而是用于变量映射，但结合 try_files、alias 或 root，可以实现静态资源的动态路径分发——核心是把请求特征（如域名、URI 前缀、Header）映射为路径变量，再在 location 中引用。
用 map 提取并映射请求特征到路径变量
比如根据子域名决定静态资源根目录：
map $host $static_root {
hostnames;
~^(?<subdomain>[^.]+)\.example\.com$ /var/www/$subdomain/static;
default /var/www/default/static;
}</subdomain>
这里用正则捕获子域名，并构造对应目录路径；hostnames 允许通配和正则匹配；$subdomain 是命名捕获组，可直接在右侧使用。
在 location 中引用映射变量定位资源
有了 $static_root，就可以配合 alias 或 root 使用：
- 用
alias（推荐用于精确匹配路径前缀）：location /static/ {<br> alias $static_root/;<br> expires 1h;<br>} - 用
root（注意路径拼接逻辑）：location /static/ {<br> root $static_root;<br> # 实际查找路径为 $static_root/static/xxx<br>}
注意：alias 会替换整个匹配部分，root 是追加 URI，二者行为不同，选错会导致 404。
结合 URI 路径做更细粒度映射
例如按 URL 中的版本号选择资源目录：
map $uri $versioned_path {
~^/v(?<ver>\d+\.\d+)/(.*)$ /var/www/api/$ver/$2;
default /var/www/api/latest/$1;
}</ver>
再配合内部重写或 try_files：
- 搭配
try_files回退：location /v {<br> try_files $versioned_path =404;<br>} - 或用
rewrite+last转交（慎用，避免循环）：rewrite ^/v(\d+\.\d+)/(.*)$ /$2 last;（需配合 root 设置）
注意事项与常见坑
map 块必须定义在 http 块内，不能放在 server 或 location 里；映射结果仅支持字符串，不支持嵌套 map 或复杂逻辑；变量值为空时默认为未定义，可能触发 default 分支或导致空路径错误。
调试建议：开启 error_log notice，用 log_format 打印变量值验证映射是否生效，例如：log_format debug '$remote_addr - $host "$request" $status $static_root';
