Mongoose如何填充Post评论数组中所有评论的user字段？

问题背景 #

我正在开发一个博客应用，定义了Post和Commentary两个Mongoose模型，现在遇到了无法对Post中commentary数组内的评论执行populate("user")的问题，具体代码如下：

现有模型定义 #

Post模型

const PostSchema = new mongoose.Schema(
  {
    title: {
      type: String,
      required: true,
    },
    text: {
      type: String,
      required: true,
      unique: true,
    },
    tags: {
      type: Array,
      default: [],
    },
    viewsCount: {
      type: Number,
      default: 0,
    },
    user: {
      type: mongoose.Schema.Types.ObjectId,
      ref: "User",
      required: true,
    },
    commentary: {// 当前存储完整评论对象
      type: Array,
      default: [],
    },
    imageUrl: String, 
  },
  {
    timestamps: true,
  }
);

Commentary模型

const CommentarySchema = new mongoose.Schema({
  text: {
    type: String,
    required: true,
  },
  post: {
    type: mongoose.Schema.Types.ObjectId,
    ref: "Post",
    required: true,
  },
  user: {
    type: mongoose.Schema.Types.ObjectId,
    ref: "User",
    required: true,
  },
});

现有添加评论接口 #

export const createCommentary = async (req, res) => {
  try {
    const postId = req.params.id;

    const doc = new Commentary({
      text: req.body.text,
      post: postId,
      user: req.userId,
    });
    const comment = await doc.save();

    await PostModel.findOneAndUpdate(
      {
        _id: postId,
      },
      {
        $push: { commentary: comment }, // 存入完整评论对象
      }
    );

    res.json({ success: true });
  } catch (err) {
    console.log(err);
  }
};

现有获取单篇文章接口（尝试populate评论用户失败） #

export const getOne = async (req, res) => {
  try {
    const postId = req.params.id;

    const doc = await PostModel.findOneAndUpdate(
      {
        _id: postId,
      },
      {
        $inc: { viewsCount: 1 },
      },
      { returnDocument: "after" }
    ).populate("user").populate("commentary.user");
    
    if (!doc) {
      return res.status(404).json({ message: "Can not res post" });
    }

    res.json(doc);
  } catch (err) {
    console.log(err);
    res.status(500).json({
      message: "Can not find post",
    });
  }
};

我尝试了两种方式都没成功：

.populate("user").populate("commentary.user");
// 以及
const arrOfPromises = doc.commentary.map((comment) =>
        comment.populate("user")
      );
await Promise.all(arrOfPromises);

请问正确的实现方式是什么？是否应该在Post的commentary数组中存储评论ID而非完整的评论对象？

解决方案 #

核心问题 #

当前Post模型的commentary字段是普通数组，存储的是完整的Commentary文档对象，Mongoose无法识别这些对象属于Commentary模型，因此无法对其中的user字段执行关联populate。同时从数据库读出的commentary数组元素是纯JSON对象，并非Mongoose Document实例，手动调用populate方法也无效。

正确实现步骤 #

1. 修改Post模型的commentary字段定义

将commentary改为存储Commentary的ID引用，而非完整对象：

const PostSchema = new mongoose.Schema(
  {
    // 其他字段保持不变
    commentary: [{
      type: mongoose.Schema.Types.ObjectId,
      ref: "Commentary", // 关联到Commentary模型
      default: []
    }],
    // 其他字段保持不变
  },
  { timestamps: true }
);

2. 修改添加评论的接口逻辑

只将评论的_id存入Post的commentary数组：

export const createCommentary = async (req, res) => {
  try {
    const postId = req.params.id;

    const doc = new Commentary({
      text: req.body.text,
      post: postId,
      user: req.userId,
    });
    const comment = await doc.save();

    // 只push评论ID，而非完整对象
    await PostModel.findOneAndUpdate(
      { _id: postId },
      { $push: { commentary: comment._id } }
    );

    res.json({ success: true });
  } catch (err) {
    console.log(err);
    res.status(500).json({ message: "Failed to create comment" });
  }
};

3. 修改获取单篇文章的接口，实现嵌套populate

先populate整个commentary数组（关联到Commentary模型），再嵌套populate评论中的user字段：

export const getOne = async (req, res) => {
  try {
    const postId = req.params.id;

    const doc = await PostModel.findOneAndUpdate(
      { _id: postId },
      { $inc: { viewsCount: 1 } },
      { returnDocument: "after" }
    )
    .populate("user") // 填充文章作者
    .populate({
      path: "commentary", // 先填充所有评论
      populate: { path: "user" } // 再填充每个评论的用户
    });
    
    if (!doc) {
      return res.status(404).json({ message: "Post not found" });
    }

    res.json(doc);
  } catch (err) {
    console.log(err);
    res.status(500).json({ message: "Failed to fetch post" });
  }
};

为什么这种方式更合理 #

• 这是MongoDB中处理关联数据的常规设计，数据一致性更好：后续修改评论内容时，只需更新Commentary文档，无需同步修改Post中的commentary数组。
• 减少数据冗余：避免在Post中重复存储评论的完整内容，节省存储空间。
• Mongoose的populate机制可以完美支持这种嵌套关联查询，实现预期的用户信息填充。

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