Mongoose populate使用select投影时虚拟属性报length未定义错误

报错的核心原因是Mongoose虚拟字段的计算逻辑依赖查询返回的真实文档字段：

• 你定义的itemsCount虚拟字段需要读取this.items的长度，只要查询返回的User文档中不包含items字段，this.items就为undefined，访问.length自然会抛出Cannot read properties of undefined (reading 'length')错误。
• 你当前写的select: { itemsCount: 0 }本身也不符合需求：你要隐藏的是items字段而非itemsCount，且Mongoose不会在投影阶段自动保留虚拟字段依赖的真实字段，只要你在查询投影中排除items，就会触发上述报错。

核心思路是：查询阶段保留items字段保证虚拟字段正常计算，在最终序列化输出的时候再隐藏items字段，具体修改如下：

• 第一步：优化UserSchema配置，在序列化环节自动剔除items字段，同时给虚拟字段加空值兼容，避免极端场景报错：

const UserSchema = mongoose.Schema(
  {
    username: { type: String, lowercase: true, required: true },
    items: { type: [mongoose.Types.ObjectId], default: [] },
  },
  {
    toJSON : {
      virtuals : true,
      // 序列化转JSON时自动删除items字段
      transform: (doc, ret) => {
        delete ret.items;
        return ret;
      }
    },
    // 兼容toObject/lean等场景的输出
    toObject: {
      virtuals: true,
      transform: (doc, ret) => {
        delete ret.items;
        return ret;
      }
    },
    timestamps: true,
  }
);

// 加可选链做兜底，避免items不存在时抛错
UserSchema.virtual("itemsCount").get(function () {
  return this.items?.length || 0;
});

module.exports = {
  UserModel: mongoose.model("user", UserSchema ),
};

• 第二步：修改查询逻辑，去掉错误的select投影配置，正常populate即可：

const newPosts = await ProductModel.find({}).populate([{ path: "owner" }]);

最终返回结果中会自动携带itemsCount字段，且不会展示items字段，也不会触发报错。

临时场景处理 #

如果你不需要全局隐藏items，只需要在当前查询中隐藏，可以在查询拿到结果后手动处理字段：

const newPosts = await ProductModel.find({}).populate([{ path: "owner" }]);
const result = newPosts.map(post => {
  const data = post.toJSON();
  delete data.owner.items;
  return data;
})

注意：不要给items字段加select: false配置，该配置会让items默认不被查询返回，直接导致虚拟字段计算失败。

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