为何Node.js中userSchema.toJSON用async函数会隐藏全部数据？普通函数正常

这问题我之前排查过，核心原因和toJSON方法的设计逻辑、异步函数的特性直接相关，咱们把它拆解开说：

1. 先搞懂toJSON的作用 #

当你用JSON.stringify()序列化一个对象时，JavaScript会自动触发该对象的toJSON方法，然后用这个方法的返回值来完成序列化。它的预期是返回一个「可以直接被序列化的同步值」——比如普通对象、字符串、数字这类，而不是异步操作的产物。

2. 异步函数的“隐藏特性” #

你把toJSON改成async function后，这个方法的返回值就不再是你手动return的userObject了——所有异步函数都会自动把返回值包装成Promise对象，哪怕你return的是一个普通值也不例外。

3. 问题的核心矛盾 #

当JSON.stringify调用这个异步版本的toJSON时，它拿到的是一个Promise，而不是你处理好的用户对象。JSON.stringify根本不知道怎么处理Promise，只会把它当成普通对象序列化，最终输出的是Promise的内部结构（比如{ _state: 1, _value: ... }这类奇怪的内容），完全不是你想要的结果。

解决方案 #

针对你的场景 #

你的代码里没有任何真正的异步操作（user.toObject()、delete都是同步执行的），所以完全没必要用async函数，保持普通函数写法就好，这也是为啥普通函数一切正常。

如果未来需要异步操作 #

要是之后真的需要在用户序列化前做异步操作（比如从数据库拉取关联数据），不能直接把toJSON改成async，得换个思路：

// 定义一个异步的处理方法，不要用toJSON
userSchema.methods.getPublicData = async function() {
  const extraData = await someAsyncDbCall(); // 比如异步拉取用户的额外信息
  const userObject = this.toObject();
  userObject.extraInfo = extraData;
  delete userObject.password;
  delete userObject.tokens;
  return userObject;
};

// 使用时先手动调用异步方法，再序列化
const user = await User.findById('xxx');
const publicUserData = await user.getPublicData();
const jsonStr = JSON.stringify(publicUserData);

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