Mongoose中<ref *1>标识含义、去除方法及数据传输优化

一、<ref *1>标识是什么？怎么去掉？ #

• 含义：这是Node.js处理循环引用对象时的默认标记，当Mongoose文档存在循环引用（比如A文档引用B，B又反向引用A），Node.js就会用<ref *N>标记引用的循环节点，方便识别对象结构里的循环关系。
• 去除方式：
  1. 转成纯JS对象：Mongoose文档自带toObject()或toJSON()方法，能剥离内部的循环引用标记和Mongoose专属属性，转成普通JS对象后打印就不会有这个标识了：

     const plainUser = user.toObject();
     console.log(plainUser);
     

  2. JSON序列化时处理：如果要直接打印，用JSON.stringify()并添加循环引用处理逻辑，比如只保留引用ID：

     console.log(JSON.stringify(user, (key, val) => {
       if (val?._id && typeof val === 'object') return val._id;
       return val;
     }, 2));
     

二、后端筛选categoryLinks，提升前端性能 #

把完整的categoryLinks传给前端会导致前端处理冗余数据，直接在后端把需要的数据筛好再传：

• Populate时指定字段：如果categoryLinks是关联其他集合的引用，在populate阶段就只拉取需要的字段（比如只取label和_id），减少数据传输量：

  const user = await User.findById(userId)
    .populate('categoryLinks', 'label _id'); // 第二个参数指定要返回的字段
  

• 手动过滤数组：如果已经拿到完整数据，用数组filter方法筛出符合条件的项：

  // 示例：只保留label不为空的链接
  const filteredLinks = user.categoryLinks.filter(link => link.label?.trim());
  // 把筛选后的数组传给EJS
  res.render('page', { categoryLinks: filteredLinks });
  

• 聚合查询处理复杂筛选：如果需要更复杂的筛选逻辑（比如多条件过滤、统计），用Mongoose聚合管道一步完成查询和筛选：

  const [filteredUser] = await User.aggregate([
    { $match: { _id: mongoose.Types.ObjectId(userId) } },
    { $lookup: {
        from: 'categories', // 关联的集合名称
        localField: 'categoryLinks',
        foreignField: '_id',
        as: 'categoryLinks'
      }
    },
    { $project: {
        categoryLinks: {
          $filter: {
            input: '$categoryLinks',
            as: 'link',
            cond: { $and: [
              { $ne: ['$$link.label', null] },
              { $gte: ['$$link.sortOrder', 1] } // 再加个排序条件示例
            ] }
          }
        }
      }
    }
  ]);
  
  res.render('page', { categoryLinks: filteredUser.categoryLinks });
  

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