自引用树形结构需显式声明parent字段为Schema.Types.ObjectId并ref自身模型名，如ref: 'Category'；查子节点须判空且过滤软删除；children需虚拟字段+virtuals:true；整树查询用$graphLookup并配准maxDepth和restrictSearchWithMatch。
parent 字段必须声明为 Schema.Types.ObjectId 并手动 ref 自身模型
自引用树形结构的关键不是“能不能”，而是 Mongoose 不会自动识别 parent 指向本模型——它默认当普通 ObjectId 处理，不做 populate 关联。你得显式告诉它：“这个字段 ref 的是当前模型”。
-
parent字段定义必须带ref，且值为对应模型名（不是集合名，也不是文件路径），例如：ref: 'Category' - 模型名要和
mongoose.model('Category', schema)中第一个参数完全一致，大小写敏感 - 不能省略
type，写成{ type: Schema.Types.ObjectId, ref: 'Category' }；只写String或不写 type 会导致 populate 失败 - 如果模型定义在模块导出前就用到了（比如 schema 里直接写
ref: Category），会报ReferenceError—— 此时只能用字符串名
查询子节点时别直接用 find({ parent: id }) 就完事
看似能查出一级子分类，但漏掉两个关键问题：一是没过滤已删除节点（isDeleted: true 类字段常被忽略），二是没处理 null / undefined 的 parent 值导致意外匹配。
- 确保
parent字段允许null，并在 schema 中设default: null，避免存入空字符串或0等假值 - 查子节点时加显式判空：
{ parent: { $eq: categoryId } }，而不是{ parent: categoryId }（后者在 categoryId 为null时可能命中所有 parent 为 null 的文档） - 如果业务需要支持软删除，务必在查询条件中加上
{ isDeleted: false }，否则树形遍历会漏数据或混入脏数据
populate('parent') 能用，但 populate('children') 得靠反向虚拟字段 + virtuals: true
Mongoose 默认不支持“正向存 parent、反向查 children”，因为没有物理的 children 字段。想用 populate('children')，必须手动加虚拟字段并启用 toObject 和 toJSON 选项，否则序列化时看不到。
- 在 schema 中添加虚拟字段：
categorySchema.virtual('children', { ref: 'Category', localField: '_id', foreignField: 'parent' }) - 必须启用：
categorySchema.set('toObject', { virtuals: true }); categorySchema.set('toJSON', { virtuals: true }); - 调用时用
.populate('children')可以，但注意深度：Mongoose 不支持无限递归 populate，两层以上得手写聚合管道或分步查 - 虚拟字段不会存进数据库，所以
children在 raw MongoDB 查询里不存在，仅限 Mongoose 层使用
用聚合管道查完整树时，$graphLookup 的 maxDepth 和 restrictSearchWithMatch 很容易配错
想一次查出某节点下的整棵子树？$graphLookup 是唯一靠谱方案，但三个参数稍有偏差就会返回空数组或全量数据。
-
from必须填集合名（如'categories'），不是模型名；可用Category.collection.name动态取 -
maxDepth从 0 开始计数：设为0只查直接子节点，1查到孙子，以此类推；别误以为是“层级总数” -
restrictSearchWithMatch必须包含{ isDeleted: false }，否则软删除节点仍会被纳入图遍历，污染结果 -
startWith要用$toString或确保传入的是 ObjectId 实例，传字符串 ID 且没转类型会导致匹配失败
