如何基于带通配符的正则实现Nginx location路由匹配URL参数

核心原因 #

Nginx的location块的匹配规则仅作用于URL中?之前的URI路径部分，不会包含?之后的查询参数（Query String）。你原来的配置尝试在路径中匹配param2=somevalue，而实际路径里只有/api/v1/action这类内容，所以永远无法命中规则。

正确实现方案 #

Nginx内置了$arg_<参数名>变量，可以直接获取指定查询参数的值，结合if判断即可实现你的需求：

# 先匹配所有/api开头的请求
location ~* ^/api/ {
    # 判断param2的取值是否为指定的somevalue
    if ($arg_param2 = "somevalue") {
        # 转发到指定地址或命名location
        proxy_pass http://你的目标转发地址;
        # 如需转发到命名location，使用下面的写法
        # rewrite ^ @location last;
    }
    # 其他非匹配请求的默认处理逻辑
    proxy_pass http://默认上游服务地址;
}

补充说明 #

• 如果需要模糊匹配参数值，可使用正则匹配写法：

  # 不区分大小写匹配param2值包含somevalue的请求
  if ($arg_param2 ~* "somevalue") {
      # 处理逻辑
  }
  

• 优先使用$arg_<参数名>的方式取值，比直接匹配$query_string变量更可靠，不会受参数顺序、其他相似参数名的干扰
• 单个if判断在location块内使用是安全的，无需刻意规避

内容的提问来源于stack exchange，提问作者Pavel Polushin