Nginx 中怎样通过 map 指令实现静态资源的动态路径匹配

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;}

这里用正则捕获子域名，并构造对应目录路径；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;}

再配合内部重写或 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';