TypeScript中抛出错误时出现循环结构转JSON错误求助

错误原因分析 #

这个错误的核心是JSON序列化遇到了循环引用的对象，提示里提到的Socket构造函数创建的对象，大概率是错误对象或HTTP响应/请求上下文里包含了Socket实例（比如请求链路中的连接对象），这类对象存在循环引用（比如Socket引用了请求，请求又引用了Socket），无法被JSON.stringify正常处理。

场景1：抛出错误时的问题 #

你的updateGroup方法的catch块中，直接将原生Error对象传入response.json()：

return response.status(500).json({ message: "Internal server error", error })

原生Error对象除了message和stack，还可能包含与当前请求上下文绑定的属性（比如关联的Socket连接），这些属性存在循环引用，导致序列化失败。

场景2：返回空对象时的问题 #

看似返回空对象{}不会有问题，但大概率是你的响应对象（response）已经被之前的中间件或错误处理逻辑修改，附加了带有循环引用的属性（比如Socket实例）。当调用response.json()时，框架可能会隐式地序列化整个response对象的某些附加属性，而非仅你传入的空对象。

解决方案 #

1. 正确处理错误序列化 #

不要直接返回原生Error对象，而是提取可序列化的属性：

catch (error) {
  // 提取错误的关键信息，避免序列化整个Error对象
  const errorInfo = {
    message: error instanceof Error ? error.message : "Unknown error",
    stack: process.env.NODE_ENV === 'development' ? error.stack : undefined
  };
  return response.status(500).json({ 
    message: "Internal server error", 
    error: errorInfo 
  });
}

2. 避免直接返回ORM实体 #

你的updateGroup中直接返回了updatedGroup（ORM查询得到的实体），这类实体通常包含与数据库连接、Repository相关的循环引用属性（比如EntityManager、关联的加载器）。需要转换成纯数据对象（DTO）：

// 转换为纯JSON对象，剥离ORM附加的属性
const groupDto = {
  id: updatedGroup.id,
  name: updatedGroup.name
  // 其他需要返回的字段
};
return response.status(200).json(groupDto);
// 或者用实例方法转换（如果ORM支持）
// return response.status(200).json(updatedGroup.toJSON());

3. 排查响应对象的附加属性 #

对于runFilter返回空对象仍报错的情况，检查项目中的中间件（比如Socket相关的中间件、日志中间件）是否给request或response对象添加了循环引用的属性。可以在调用response.json()前打印response的结构，找到附加的循环引用属性并移除，或者确保中间件不会修改响应对象的核心结构。

4. 手动处理循环引用（可选） #

如果必须序列化包含循环引用的对象，可以使用自定义的JSON序列化函数，忽略循环引用的属性：

function stringifyCircular(obj: any) {
  const seen = new WeakSet();
  return JSON.stringify(obj, (key, value) => {
    if (typeof value === "object" && value !== null) {
      if (seen.has(value)) {
        return; // 跳过循环引用的对象
      }
      seen.add(value);
    }
    return value;
  });
}

// 使用时：
response.status(500).send(stringifyCircular({ message: "Internal server error", error }));

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