聚合管道返回空结果主因是游标未消费、阶段顺序不当或字段类型不匹配；需确保主动遍历游标、$lookup加preservenullandemptyarrays、严格校验字段名与类型。
聚合管道返回空结果，绝大多数情况不是数据不存在，而是管道写法或执行方式有问题。
聚合返回空但 Compass 能查到
这是最常见错觉：你在 Compass 里粘贴管道能出结果，代码里一模一样却返回空。根本原因通常是 Aggregate() 返回的是游标（cursor），不是数据本身；你没真正消费它。
- Go 中必须调
cursor.Next(ctx)或cursor.All(ctx)才会发请求，只声明变量不触发执行 - Python 的
collection.aggregate(pipeline)同样返回惰性游标，list(cursor)或循环才拉数据 - Java 驱动里
collection.aggregate(pipeline).iterator()也得主动hasNext()/next() - 别用
if cursor:判断——游标对象永远为真，毫无意义
管道阶段顺序导致中间结果被过滤光
比如你写了 $match → $lookup → $unwind → 再 $match，而 $lookup 结果为空，$unwind 就把整条文档删了，后续 $match 没东西可筛。
-
$lookup默认不保留空匹配，想保留得加preserveNullAndEmptyArrays: true - 跨集合校验时，
localField和foreignField类型必须严格一致："123"≠123，null≠[] - 如果只关心“有没有关联记录”，优先用
$lookup+$addFields+$size判断数组长度，比$unwind安全
字段投影或类型转换让匹配失效
你查 {"name": "Alice"}，但管道里先用了 $project 把 name 改成小写，再 $match 就永远匹配不上。
-
$project后字段名变了、类型转了（比如$toDate）、甚至被删了，后续阶段就找不到原字段 - 用
$type阶段提前检查字段类型：{"$match": {"status": {"$type": "string"}} - 字符串 ID 和 ObjectId 混用是高频雷区：数据库存的是
ObjectId，你传字符串进去，$in或$eq全部失效
聚合阶段语法错误被静默忽略
MongoDB 对某些非法结构不报错，而是跳过整个阶段——比如 $match 里写了两个键：{"$match": {"a": 1, "b": 2}}，会直接报 A pipeline stage specification object must contain exactly one field；但如果写成 {"$match": {"a": 1}} + 额外字段没包进 $match，可能整个阶段被丢弃。
- 每个阶段对象必须且只能有一个顶层键，如
{"$group": {...}}，不能多一个"_id"平级字段 - Go 的
bson.M如果 key 写错（比如"match"漏了$），MongoDB 当作普通字段忽略，不报错也不执行 - Java 驱动里误把
Filters.and()直接塞进管道（而非包在Aggregates.match()里），会生成{"$and": []}，触发Unrecognized pipeline stage name: '$and'
空结果背后往往不是数据丢了，而是管道某处悄悄断掉了数据流——要么阶段没执行，要么字段被改名，要么类型对不上。盯住游标消费、阶段顺序、字段生命周期这三点，基本能定位 90% 的“空返回”问题。
