本文详解 Express 应用中 req.body 显示为 [Object] 而非原始 JSON 结构的根本原因，阐明 console.log() 的默认对象缩略行为并非解析失败，并提供服务端配置、调试技巧与生产级最佳实践。
本文详解 express 应用中 `req.body` 显示为 `[object]` 而非原始 json 结构的根本原因，阐明 `console.log()` 的默认对象缩略行为并非解析失败，并提供服务端配置、调试技巧与生产级最佳实践。
在 Node.js + Express 构建的后端服务中，开发者常遇到一个看似“诡异”的现象：Java（或其他客户端）成功发送了结构清晰的 JSON 数组，Express 路由中 console.log(req.body) 却只打印出嵌套的 [Object]，例如：
[
{
name: 'Game',
blocks: [ [Object], [Object], /* ... 10 个 [Object] */ ]
}
]这并不表示 JSON 解析失败，而是 console.log() 对深度嵌套对象的默认输出策略——为避免终端刷屏，Node.js 会自动对超过一定层级的对象进行简化显示（即 util.inspect 的默认深度限制为 2）。实际 req.body 已被正确解析，只是未完整展开。
✅ 验证方法：使用 JSON.stringify() 或 util.inspect() 显式查看完整结构
const express = require('express');
const app = express();
// ✅ 必须启用 JSON 解析中间件（且顺序正确）
app.use(express.json({ limit: '10mb' })); // 解析 application/json
app.use(express.urlencoded({ extended: true, limit: '10mb' })); // 兼容表单等格式
const port = 80;
app.post('/', (req, res) => {
// ❌ 错误：直接 console.log(req.body) → 输出缩略形式
console.log('❌ req.body (default log):', req.body);
// ✅ 正确：完整序列化查看原始结构
console.log('✅ req.body (full JSON):', JSON.stringify(req.body, null, 2));
// ✅ 或使用 util.inspect 深度展开（推荐开发调试）
const util = require('util');
console.log('? req.body (deep inspect):', util.inspect(req.body, { depth: null, colors: true }));
res.status(200).json({ success: true, received: req.body.length });
});
app.listen(port, () => {
console.log(`Server running on http://localhost:${port}`);
});? 关键前提：确保中间件配置无误
上述方案生效的前提是 express.json() 已正确启用：
- 必须在 app.post() 路由定义之前调用 app.use(express.json())；
- Content-Type: application/json 请求头必须由客户端（如 Java 的 con.setRequestProperty("Content-Type", "application/json")）准确设置；
- 若同时接收表单或 URL 编码数据，务必补充 express.urlencoded({ extended: true })。
⚠️ Java 客户端注意事项（补充验证点）
您的 Java 代码整体正确，但建议增强健壮性：
- 添加字符集显式声明：os.write(input, 0, input.length); → 改为 os.write(input); 即可（getBytes("utf-8") 已保证编码）；
- 检查响应状态码后读取响应体，避免连接提前关闭导致调试信息丢失；
- 可临时用 curl 验证服务端行为：
curl -X POST http://localhost:80 \ -H "Content-Type: application/json" \ -d '[{"name":"Game","blocks":[{"shape":[2,2],"position":[0,1]}]}]'
? 生产环境建议
- 避免在生产日志中 JSON.stringify(req.body)（可能泄露敏感数据），改用结构化日志库（如 pino）并选择性脱敏字段；
- 为 express.json() 设置合理 limit（如 '10mb'）防止恶意大 Payload；
- 始终对 req.body 进行运行时校验（如使用 zod 或 joi），而非仅依赖 console.log 判断解析结果。
综上，[Object] 是控制台输出的视觉假象，而非解析故障。真正的问题从来不在 JSON 本身，而在于我们如何观察它——掌握 JSON.stringify 和 util.inspect 的正确用法，是每个 Express 开发者调试请求体的必备基本功。
