Nginx反向代理配置问题：无法转发Express.js路由的id参数

问题场景 #

Express应用中定义了如下路由，期望通过:id参数获取对应数据：

router.get("/:id", async (req, res, next) => {
  try {
    // debug(`The req  is ${req.params.id}`);
    const data = await getSuperHerors(req.params.id);
    res.send(data);
  } catch (err) {
    next(err);
  }
});

配置Nginx反向代理后，发现id参数无法正确转发到后端Express服务，尝试过注释中的配置也未解决，当前Nginx配置如下：

server {
root /var/www/html;

    server_name example.biz; # managed by Certbot
    location / {
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_pass http://127.0.0.1:3000;

            # proxy_pass http://127.0.0.1:3000/$1$is_args$args;

            # set $upstream http://localhost:3000;
            # proxy_pass $upstream/$1$is_args$args;
    }

    listen [::]:443 ssl ipv6only=on; # managed by Certbot
    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/example.biz/fullchain.pem; 
    ssl_certificate_key /etc/letsencrypt/live/example.biz/privkey.pem; 
    include /etc/letsencrypt/options-ssl-nginx.conf; 
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; 
}

server {
    if ($host = example.biz) {
        return 301 https://$host$request_uri;
    } # managed by Certbot


        listen 80 ;
        listen [::]:80 ;
    server_name example.biz;
    return 404; # managed by Certbot
}

问题分析 #

1. 注释配置中的$1变量无效：当前location /是前缀匹配规则，未使用正则表达式捕获路径分组，$1为空值，导致拼接后的转发路径缺失id部分。
2. 默认proxy_pass配置本身支持路径转发：默认的proxy_pass http://127.0.0.1:3000;会自动将完整请求路径（包括/id）转发到后端，若此配置下仍无法获取参数，需排查Express路由挂载或端口监听问题。

正确配置方案 #

方案1：保留默认前缀匹配配置（推荐） #

默认配置已能正确转发完整路径，若仍无法获取参数，需做以下检查：

• 确认Express应用确实监听127.0.0.1:3000
• 检查Express路由的挂载路径：若路由是挂载在/api等子路径下，需调整Nginx的location规则对应匹配
• 查看Nginx日志（/var/log/nginx/access.log和error.log），验证转发的请求路径是否正确

方案2：正则式捕获路径（按需使用） #

如果需要更精确控制路径转发，可给location添加正则捕获规则：

location ~ ^/(.*)$ {
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://127.0.0.1:3000/$1$is_args$args;
}

此规则通过^/(.*)$正则捕获除根路径外的所有内容到$1，拼接后转发给后端，确保id参数完整传递。

生效配置 #

修改Nginx配置后，执行以下命令确保配置正确并重启服务：

sudo nginx -t
sudo systemctl reload nginx

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