Docker部署Node.js API与React应用后POST请求body为空如何解决

按优先级依次排查以下问题：

1. 检查中间件注册顺序 #

Express 中间件按注册顺序执行，解析中间件必须放在路由注册之前，错误和正确的示例如下：

// 错误写法
app.post('/metrics', saveMetric) // 先注册路由
app.use(express.json()) // 后注册解析中间件，无法解析前面路由的请求体
app.use(express.urlencoded())

// 正确写法
app.use(express.json()) // 先注册解析中间件
app.use(express.urlencoded({ extended: true })) // 添加强制配置避免低版本兼容问题
app.post('/metrics', saveMetric) // 后注册路由

2. 调整JSON解析大小限制 #

express.json()默认请求体大小限制为100kb，如果提交的JSON数据超过该阈值，会直接丢弃请求体，可手动调大限制：

app.use(express.json({ limit: '10mb' })) // 根据实际业务数据大小调整阈值

3. 验证请求链路的头/体透传配置 #

如果Docker部署时用了Nginx、APISIX等反向代理或者网关服务，检查以下配置：

• 是否透传了Content-Type请求头到后端API服务
• 是否允许POST请求的请求体透传，有没有配置client_max_body_size等限制拦截了请求体
• 没有修改请求方法或者丢弃请求体的规则

4. 前后端双重验证请求内容 #

• 前端fetch请求前打印序列化后的请求体：console.log(JSON.stringify(getPerfanalytics().values))，确认不是空对象/空字符串
• 后端路由前添加临时调试中间件，打印原始请求体，确认请求链路是否正常传递了内容：

// 放在所有中间件的最顶部
app.use((req, res, next) => {
  let rawBody = ''
  req.on('data', chunk => rawBody += chunk)
  req.on('end', () => {
    console.log('原始请求体内容：', rawBody)
    console.log('请求Content-Type：', req.headers['content-type'])
    next()
  })
})

如果原始请求体为空，则问题出在前端或者链路传输层；如果原始请求体有内容但req.body为空，则问题出在express解析中间件的配置。

5. 检查跨域配置 #

如果使用了cors中间件处理跨域，需要保证cors中间件注册在所有解析中间件和路由的前面，避免预检请求被拦截导致请求体解析异常：

// 正确顺序
const cors = require('cors')
app.use(cors()) // 先注册cors中间件
app.use(express.json())
app.use(express.urlencoded({ extended: true }))
app.post('/metrics', saveMetric)

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