go中mongodb聚合查询结果为空多因pipeline结构错误；必须用[]bson.d分阶段传参，禁用bson.m合并操作符，时间字段需用bson.m包装，$group的_id须为bson.d，索引失效常因类型不匹配或未遵循最左前缀原则。
Go 里写 MongoDB 聚合查询，Aggregate() 不报错但结果为空，八成是 pipeline 结构错了；建了索引但 Explain 显示 COLLSCAN，基本不是没建成功，而是查询条件没对上索引路径或类型。
聚合 pipeline 必须用 []bson.D 拆成独立阶段
官方驱动不接受 map[string]interface{} 或 JSON 字符串直接传给 Collection.Aggregate()。错用 bson.M 合并多个操作符（比如把 $match 和 $group 写进同一个 bson.M），会导致运行时报 invalid pipeline operator 或静默返回空结果。
-
bson.D是有序文档，推荐用于聚合——尤其当阶段依赖顺序时，比如$lookup后紧跟$unwind - 每个阶段必须是独立的
bson.D，不能写成bson.D{{"$match", ...}, {"$sort", ...}}；正确写法是[]bson.D{{{"$match", ...}}, {{"$sort", ...}} - 时间字段别直接传
time.Now()，得包进bson.M{"$gte": start, "$lt": end}，其中start/end是time.Time类型 -
$group的_id不能写成字符串"status"，得用bson.D{{"_id", "$status"}}；计数要用"$sum"，不是"count"
字符串字段索引失效的三个硬坑
MongoDB 对 BSON 类型极其敏感。字段存的是 "active"（string），但查询传了 1（int64），哪怕索引存在也完全不命中。
- 查原始数据类型：
db.collection.findOne().status看实际值和类型；建索引前先用bson.M{"status": bson.M{"$type": "string"}}过滤验证字段内容是否统一 - 复合索引遵循最左前缀原则：索引
{"category": 1, "title": 1}，只查{"title": "xxx"}就不生效；高频单字段查，单独建索引更稳 - Go 里建索引必须用
CreateIndex（EnsureIndex已弃用），且mongo.IndexModel的Keys要显式匹配字段路径，比如子文档里的address.city得写成bson.D{{"address.city", 1}}
执行聚合时游标和解码的常见翻车点
别假设 Cursor.All() 总能一次性读完——大数据量下它可能超时或网络中断，而 cursor.Next() 返回 false 并不代表结束，得看 cursor.Err()。
- 始终用
context.WithTimeout()包裹Collection.Aggregate()，避免无限挂起 - 遍历必须写成
for cursor.Next(ctx) { ... }，每次循环内调用cursor.Decode(&result)，不能复用同一变量地址解码多条（会覆盖） - 结果结构不确定时可用
bson.M接收，但嵌套字段如doc["total"]类型仍是interface{}，需手动断言：v, ok := doc["total"].(int32)
真正容易被忽略的，是聚合阶段里那些看似合法的字符串字面量——比如 "$clktime" 直接塞进 bson.M 会编译失败，它得作为 []interface{} 的元素出现；还有地理索引场景下，location 字段少一个 "type": "Point"，整个 2dsphere 索引就形同虚设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
