Node.js中如何将完整req对象转为JSON响应？遇循环引用等问题

为什么三种方法都达不到预期？ #

• JSON.stringify(req)报错：Node.js的req对象内部存在循环引用（比如req.res指向对应响应对象，而res.req又会指回req），JSON序列化机制无法处理这种互相引用的结构，所以抛出TypeError。
• String(req)/req.toString()返回[object Object]：这是JavaScript对象的默认toString()行为，除非对象自身重写了这个方法，否则都会返回这个固定字符串，没法展示对象实际内容。
• console.log(req)能正常打印：Node.js的console.log底层用了util.inspect()方法，这个方法专门处理了循环引用的对象，会递归展开并标记循环引用部分，所以能正常输出对象详情。

如何把完整req对象放入res的JSON响应？ #

方法1：用Node.js内置的util模块序列化 #

用util.inspect()把req转成带格式的字符串，再返回给客户端：

const util = require('util');

app.use((req, res) => {
  const reqStr = util.inspect(req, { depth: null, showHidden: true });
  res.json({ request: reqStr });
});

• depth: null：展开所有层级的属性，不限制深度
• showHidden: true：显示对象的隐藏属性（比如req上的内部属性）

方法2：手动过滤循环引用属性后转JSON #

如果一定要返回JSON格式（不是字符串），需要手动排除循环引用的属性，比如：

app.use((req, res) => {
  // 用JSON.stringify的第二个参数过滤循环引用属性
  const reqJson = JSON.stringify(req, (key, value) => {
    if (key === 'res') return undefined;
    return value;
  });
  res.json({ request: JSON.parse(reqJson) });
});

这种方法需要你明确知道哪些属性是循环引用的，适合学习时手动梳理req的结构。

方法3：用第三方库处理循环引用（可选） #

比如flatted库，专门用来序列化/反序列化带循环引用的对象：

const flatted = require('flatted');

app.use((req, res) => {
  const reqJson = flatted.stringify(req);
  res.json({ request: flatted.parse(reqJson) });
});

不过学习阶段更推荐先掌握内置工具的用法。

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