Mongoose按关联字段排序失败及Lookup返回空数组求助

问题说明 #

你的Task Schema定义如下：

const TaskSchema = new mongoose.Schema({
  name: String,
  user: mongoose.Schema.Types.ObjectId
});

按name字段排序可以正常工作：

await Tasks.find().sort({name: 1})

但尝试通过populate关联user后按user.name排序时，以下写法无效：

await Tasks.find().populate('user', 'name').sort({'user.name': 1})

给populate添加排序选项也仅会对关联的user文档内部排序，无法实现整体按user.name排序。改用aggregate的$lookup时，返回的someField为空数组：

Tasks.aggregate([{ $lookup: {
  from: 'User',
  localField: 'user',
  foreignField: '_id',
  as: 'someField'
}}])

解决方案 #

1. 修复$lookup返回空数组的问题

出现空数组的核心原因是集合名称错误：Mongoose默认会将模型名转为小写复数作为集合名，比如User模型对应的集合是users，而非User。修正后的$lookup写法：

Tasks.aggregate([{ $lookup: {
  from: 'users', // 改为小写复数的集合名
  localField: 'user',
  foreignField: '_id',
  as: 'userInfo'
}}])

同时要确保Task文档的user字段存储的是有效的User文档_id，类型匹配（均为ObjectID）。

2. 实现按user.name排序的完整逻辑

要实现按关联的user.name排序，需要在aggregate管道中完成关联、拆分数组、排序三个步骤：

const sortedTasks = await Tasks.aggregate([
  // 关联users集合，获取用户信息
  {
    $lookup: {
      from: 'users',
      localField: 'user',
      foreignField: '_id',
      as: 'userInfo'
    }
  },
  // 将$lookup返回的数组拆分为单个文档（一对一关联场景）
  {
    $unwind: '$userInfo'
  },
  // 按userInfo.name升序排序
  {
    $sort: { 'userInfo.name': 1 }
  },
  // 可选：自定义返回字段结构
  {
    $project: {
      name: 1,
      user: 1,
      userName: '$userInfo.name' // 直接返回用户名，方便使用
    }
  }
]);

为什么populate的sort无效？ #

populate是Mongoose在查询Task集合之后，再单独查询关联的User集合并填充数据。而sort({'user.name':1})是在查询Task阶段执行的，此时user字段还是原始的ObjectID，并未填充为User文档，因此无法按user.name排序。populate的sort选项仅用于当一个Task对应多个User时，对关联的User列表内部排序，不适用于当前一对一关联的整体排序场景。

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