在使用 MGO 驱动进行 MongoDB 文本搜索时，若将 $meta 投影字段错误地写入查询条件（Find() 参数），会触发 “BadValue unknown operator: $meta” 错误；正确做法是通过 .Select() 方法单独声明投影，严格分离查询与投影逻辑。
在使用 mgo 驱动进行 mongodb 文本搜索时，若将 `$meta` 投影字段错误地写入查询条件（`find()` 参数），会触发 “badvalue unknown operator: $meta” 错误；正确做法是通过 `.select()` 方法单独声明投影，严格分离查询与投影逻辑。
MGO 是 Go 语言中广泛使用的 MongoDB 官方推荐前代驱动（现已被 mongo-go-driver 取代，但大量遗留项目仍在使用）。当执行全文本搜索并希望按相关度排序时，常需获取并排序 textScore。然而，一个典型误区是将 $meta 操作符直接嵌入 Find() 的查询参数中，例如：
collection.Find(bson.M{
"$text": bson.M{"$search": "mysearch"},
"score": bson.M{"$meta": "textScore"}, // ❌ 错误：$meta 不是查询操作符！
})这会导致 MongoDB 服务端报错：Can't canonicalize query: BadValue unknown operator: $meta。根本原因在于：$meta 是投影（projection）操作符，而非查询（query）操作符，它只能出现在 find 命令的 projection 字段（即 fields）中，不能混入 filter（查询条件）部分。
✅ 正确写法是将查询条件与投影逻辑解耦——使用 MGO 提供的链式方法 .Select() 显式指定投影：
result := collection.Find(bson.M{
"$text": bson.M{"$search": "mysearch"},
}).Select(bson.M{
"score": bson.M{"$meta": "textScore"},
"_id": 1,
"title": 1,
"content": 1,
})? 注意：$meta: "textScore" 必须配合 $text 查询使用，且仅在 Select()（即 projection）中合法；同时，为使排序生效，还需调用 .Sort()：
result.Sort("$text:{$meta:\"textScore\"}").All(&docs)或更清晰地写作：
result.Sort("score").All(&docs) // 前提是 Select 中已定义 "score" 字段
? 关键注意事项：
- 不可省略 .Select()：若未显式投影 score，即使排序也无法访问 textScore；
- 索引前提：确保目标字段已建立文本索引（如 db.collection.createIndex({ title: "text", content: "text" })）；
- 版本兼容性：MGO v2（labix.org/v2/mgo）完全支持 $meta 投影；旧版或 fork 分支可能存在限制；
- 替代方案提醒：新项目建议迁移到官方 go.mongodb.org/mongo-driver/mongo，其 FindOptions.Projection 和 FindOptions.Sort API 更明确、类型安全。
总结：MGO 中 $meta 的使用本质是“投影语义”，必须通过 .Select() 注入，而非拼入查询 BSON。这一设计契合 MongoDB 原生协议规范（find 命令的 filter 与 projection 为两个独立字段），也是避免此类 BadValue 错误的核心原则。
