Mongoose报错populate(...).execPopulate is not a function

报错是由Mongoose版本不兼容导致：你项目中使用的Mongoose版本为6.x或更高，该版本已正式移除文档实例上的execPopulate()方法。
版本行为差异：

• Mongoose 5.x版本：对已查询得到的单个文档实例调用.populate()不会立即执行关联字段填充，必须链式调用.execPopulate()才会返回可等待的Promise，执行实际填充逻辑
• Mongoose 6.x及以上版本：文档实例的.populate()方法本身就直接返回Promise，无需额外调用.execPopulate()，强行调用该不存在的方法就会抛出你遇到的TypeError: post.populate(...).execPopulate is not a function错误。

你代码中getPosts、getSubscribedPosts等列表接口直接在查询链上调用.populate()后直接await，没有写execPopulate()，这部分写法本来就是符合新版本规范的，只有单文档查询后填充的逻辑多写了被废弃的方法，才触发报错。

你只需要删除两处调用execPopulate()的代码即可，其他逻辑无需改动：

1. 修复getPostAndComments接口的填充逻辑
   原错误代码：

const populatedPost = await post
  .populate('author', 'username')
  .execPopulate();

修改后：

const populatedPost = await post
  .populate('author', 'username')

如果你需要在帖子详情接口填充子版块、评论关联用户等字段，可以继续链式追加.populate()，不需要额外加执行方法：

const populatedPost = await post
  .populate('author', 'username')
  .populate('subreddit', 'subredditName')
  .populate('comments.commentedBy', 'username')
  .populate('comments.replies.repliedBy', 'username')

2. 修复updatePost接口的填充逻辑
   原错误代码：

const populatedPost = await savedPost
  .populate('author', 'username')
  .populate('subreddit', 'subredditName')
  .populate('comments.commentedBy', 'username')
  .populate('comments.replies.repliedBy', 'username')
  .execPopulate();

修改后（直接删除最后一行的.execPopulate()即可）：

const populatedPost = await savedPost
  .populate('author', 'username')
  .populate('subreddit', 'subredditName')
  .populate('comments.commentedBy', 'username')
  .populate('comments.replies.repliedBy', 'username');

你可以统一代码风格，直接在查询阶段就完成关联字段填充，不需要先查出普通文档再单独调用populate，和现有列表接口的写法保持一致，逻辑更简洁。比如getPostAndComments可以改写为：

const getPostAndComments = async (req, res) => {
  const { id } = req.params;
  // 查询时直接完成所有关联字段填充
  const post = await Post.findById(id)
    .populate('author', 'username')
    .populate('subreddit', 'subredditName')
    .populate('comments.commentedBy', 'username')
    .populate('comments.replies.repliedBy', 'username');

  if (!post) {
    return res
      .status(404)
      .send({ message: `Post with ID: '${id}' does not exist in database.` });
  }

  res.status(200).json(post);
};

另外注意你在createNewPost方法里注释掉的填充逻辑，如果后续要启用，同样需要删掉execPopulate()调用，否则会触发相同报错。

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