POST请求经NGINX proxy_pass转发正常但客户端报502 Bad Gateway

预期流程 #

• 客户端 → NGINX代理 → 数据库服务器 → 返回响应给客户端

现有NGINX配置 #

server_name {site}.dev www.{site}.dev;

location / {
        # First attempt to serve request as file, then
        # as directory, then fall back to displaying a 404.
        try_files $uri $uri/ =404;
}

location /api {
        proxy_pass http://localhost:3000/api;
        # proxy_set_header Host $host;
}

NGINX服务器上的Express代码（端口3000） #

import fetch from "node-fetch";
import express from 'express';
import bodyParser from 'body-parser';

var app = express();
app.use(bodyParser.urlencoded({ extended: false }));
app.use(bodyParser.json())

var port = 3000;
const databaseServer = 'http://{ip}:3000/';
app.get('/', function(req,res) {
 res.render('index', { title: 'Express' });
})
app.post('/api', function(req, res) {
   console.log('receiving data ...');
   console.log('body is ',req.body);
 
 fetch(databaseServer, { 
   method: 'POST',
   headers: {
     'Accept': 'application/json',
     'Content-Type': 'application/json'
   },
   body: req
 }).then(async (response) => {
   const data = await response.json();
   console.log('Data from DB Listener: ', data)
   res.send(data);
 }).catch((error) => {
   console.error(error);
     res.send('Error: ', error)
 })
});

// start the server
app.listen(port);
console.log('Server started! At http://localhost:' + port);

问题现状 #

• NGINX服务器（端口3000）和数据库服务器（端口3000）均能接收到请求
• 客户端收到502 Bad Gateway响应
• 仅在设置Content-Type或body头时出现该问题

修复方案 #

1. 修正Express转发请求的body参数 #

直接将req对象传给fetch的body是错误的，req是HTTP请求对象而非可序列化的JSON数据，fetch无法正确解析，导致后端返回异常，最终NGINX返回502。

修改代码：

fetch(databaseServer, { 
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(req.body) // 替换原有的req
})

2. 完善NGINX代理头配置 #

取消注释proxy_set_header Host $host;并添加必要的转发头，确保后端服务器能正确识别请求来源：

location /api {
        proxy_pass http://localhost:3000/api;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
}

3. 规范错误响应格式 #

原错误处理的res.send('Error: ', error)会导致响应格式混乱，改为标准JSON错误响应：

.catch((error) => {
  console.error(error);
  res.status(500).json({ error: error.message });
})

4. 验证数据库服务器响应 #

确保数据库服务器的根路径（即你请求的databaseServer地址）能正确处理POST请求，并返回合法JSON数据。如果返回非JSON内容，response.json()会抛出解析错误，导致Express无法正常响应，进而触发NGINX的502错误。

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