在使用 MGO 驱动进行 MongoDB 文本搜索时，若将 $meta 操作符错误地置于查询条件（query）中而非投影（projection）中，会触发 “Can't canonicalize query: BadValue unknown operator: $meta” 错误；正确做法是通过 .Select() 方法单独指定投影。
在使用 mgo 驱动进行 mongodb 文本搜索时，若将 `$meta` 操作符错误地置于查询条件（query）中而非投影（projection）中，会触发 “can't canonicalize query: badvalue unknown operator: $meta” 错误；正确做法是通过 `.select()` 方法单独指定投影。
MongoDB 的 $meta 表达式（如 "$meta": "textScore"）仅允许出现在投影（projection）阶段，用于返回文本搜索相关元数据（如匹配得分），而不能作为查询条件的一部分。MGO 驱动严格遵循 MongoDB 协议语义，当它在查询文档（即 Find(...) 的第一个参数）中检测到 $meta 时，会将其视为非法查询操作符，从而抛出 BadValue unknown operator: $meta 错误。
常见错误写法（❌ 触发错误）：
collection.Find(bson.M{
"$text": bson.M{"$search": "mysearch"},
"score": bson.M{"$meta": "textScore"}, // ❌ 错误：$meta 出现在 query 中
})正确写法（✅ 分离 query 与 projection）：
result := collection.Find(bson.M{
"$text": bson.M{"$search": "mysearch"},
}).Select(bson.M{
"score": bson.M{"$meta": "textScore"},
"_id": 1,
"title": 1,
"content": 1,
})✅ 关键点：Find() 接收纯查询条件（filter），.Select() 才负责定义返回字段及其修饰（包括 $meta）。这与 MongoDB 原生命令 db.collection.find(query, projection) 的两参数结构完全对应。
进一步增强实用性，可结合排序与限制：
var docs []struct {
ID bson.ObjectId `bson:"_id"`
Title string `bson:"title"`
Content string `bson:"content"`
Score float64 `bson:"score"` // 注意：textScore 返回为 double 类型
}
err := result.Sort("$text:{$meta:\"textScore\"}").Limit(10).All(&docs)
if err != nil {
log.Fatal(err)
}⚠️ 注意事项：
- 确保目标字段已建立 text 索引（例如：db.collection.createIndex({ title: "text", content: "text" })），否则 $text 查询将失败；
- $meta: "textScore" 必须配合 $text 查询使用，单独在 .Select() 中声明无效；
- MGO 已归档（不再维护），生产环境建议迁移到官方驱动 mongo-go-driver，其 API 更清晰：opts.SetProjection(bson.M{"score": bson.M{"$meta": "textScore"}})；
- 若需对 textScore 排序，请在 Sort() 中显式使用字符串形式 "$text:{$meta:\"textScore\"}"（MGO 不支持嵌套 BSON 排序语法）。
总结：理解 MongoDB 查询各阶段（query / projection / sort / limit）的职责边界，是避免此类协议级错误的根本。始终将 $meta 置于投影上下文，并借助 .Select() 显式分离关注点，即可安全、高效地获取并利用文本搜索评分。
