如何编写Nginx配置实现带查询参数的请求反向代理？

针对场景二的需求，你可以在Nginx的server块中添加以下配置：

# 精确匹配路径为/subjects且携带code参数的请求
location = /subjects {
    if ($arg_code) {
        proxy_pass https://another-site.com/subjects;
        # 转发必要的请求头信息
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

关键配置说明： #

• location = /subjects：精确匹配根路径下的/subjects请求，不会与场景一中/subjects/custom_id这类带子路径的请求冲突，保证规则互不干扰。
• if ($arg_code)：仅对携带code查询参数的请求应用代理规则，精准匹配场景二的需求。
• proxy_pass https://another-site.com/subjects：Nginx会自动保留原始请求的查询参数，无需手动拼接?code=$arg_code，直接转发即可。
• 头部转发配置：proxy_set_header系列指令用于将原始请求的主机地址、客户端IP等信息传递给目标服务器，可根据实际业务需求调整或增减。

如果需要允许/subjects路径下存在其他查询参数（只要包含code就代理），也可以将location = /subjects改为location /subjects，但需注意配置顺序——精确匹配=的优先级高于普通前缀匹配，所以场景一的配置不会受影响。

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