如何将Nginx location块正则捕获的动态变量转为字符串使用

核心问题原因 #

你当前配置的核心错误是Nginx正则捕获分组的变量引用语法写反：你使用的{$1}是非法语法，Nginx中用来明确变量边界的大括号需要放在美元符号之后，正确写法为${1}。

修正后可直接使用的配置 #

location ~* /(\w+)/archive {   
  # 两种写法都可用，加{}是为了明确变量边界，避免和后续字符混淆
  fancyindex_footer "/fancyindex/footer-${1}.html";
  # 也可以简写为：fancyindex_footer "/fancyindex/footer-$1.html";
}

通用排查调试方法 #

• 先验证正则捕获是否正确：可以临时在location块内添加返回测试逻辑，确认分组取值符合预期：

  location ~* /(\w+)/archive {
    return 200 "captured value: $1";
  }
  

  重载配置后访问对应路径，看返回内容是否为你预期的分组值，确认正则捕获逻辑无误后再换回fancyindex相关配置。
• 每次修改配置后必须执行nginx -t校验语法合法性，校验通过后再执行nginx -s reload重载配置使其生效。
• 若配置生效后功能仍异常，执行nginx -V查看编译参数，确认fancyindex模块已被正确编译加载。

内容的提问来源于stack exchange，提问作者Álvaro