Nginx Location规则配置问题：针对不同action参数的请求规则设置

我来帮你搞定这个Nginx配置的问题！首先得说清楚你之前配置失效的核心原因：你写的location ^~ getBalance是在匹配URI路径里的getBalance，但你的实际请求是/stubs/handler_api.php?action=getBalance——getBalance是在Query参数里，不是路径的一部分，所以这个location规则根本匹配不到你的请求，自然不会生效。

接下来给你两种靠谱的解决方案，根据你的需求复杂度选择就行：

方案1：Location + If 判断Query参数（简单场景适用） #

这种方式适合规则比较简单的场景，直接在匹配到handler_api.php的location里，利用Nginx内置变量$arg_action（对应Query里的action参数）来分支配置：

server {
    # ... 你的其他server配置

    # 精准匹配目标文件的请求
    location /stubs/handler_api.php {
        # 处理action=getBalance的请求，可结合api_key做额外过滤
        if ($arg_action = getBalance) {
            # 这里写你的专属配置，比如转发到特定上游、自定义Header等
            proxy_set_header X-Request-Type "balance-check";
            proxy_pass http://your-balance-upstream;
            break; # 避免后续规则意外执行
        }

        # 处理action=getNumber的请求
        if ($arg_action = getNumber) {
            proxy_set_header X-Request-Type "number-request";
            proxy_pass http://your-number-upstream;
            break;
        }

        # 处理action=getStatus的请求
        if ($arg_action = getStatus) {
            proxy_set_header X-Request-Type "status-check";
            proxy_pass http://your-status-upstream;
            break;
        }

        # 默认 fallback 配置（可选，处理未匹配到的action）
        # proxy_pass http://your-default-upstream;
    }
}

如果需要针对不同api_key做更细的规则，还可以在if里叠加条件：

if ($arg_action = getBalance) && ($arg_api_key ~ ^balance-api-.*$) {
    # 仅处理api_key符合特定前缀的getBalance请求
}

方案2：用Map预处理变量（高效推荐，复杂场景适用） #

如果你的规则较多，或者想让配置结构更清晰，推荐在http块里用map来根据action参数映射到不同的上游或配置变量——这种方式比if更高效稳定，因为map在请求处理初期就完成了变量计算：

http {
    # 定义map：根据action参数选择对应的上游地址
    map $arg_action $api_target_upstream {
        getBalance http://your-balance-upstream;
        getNumber http://your-number-upstream;
        getStatus http://your-status-upstream;
        default http://your-default-upstream; # 未匹配到action的 fallback
    }

    server {
        # ... 你的其他server配置

        location /stubs/handler_api.php {
            # 统一传递api_key到上游
            proxy_set_header X-Api-Key $arg_api_key;
            # 根据map的结果转发请求
            proxy_pass $api_target_upstream;
        }
    }
}

关键提醒 #

不管用哪种方案，核心都是针对Query参数（$arg_action）做判断，而不是去匹配URI路径——这是你之前配置失效的根本原因。另外，修改完配置后一定要用nginx -t验证语法正确性，再执行nginx -s reload让配置生效。

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