本文详解 mongodb 中对复合 `_id`（如嵌入文档）进行部分字段匹配的原理与实践，指出直接构造结构体导致“not found”错误的根本原因，并提供基于 `bson.m` 的正确查询方式及完整 go 示例。
在 MongoDB 中，当 _id 字段本身是一个嵌入式文档（例如 { attr1: "foo", attr2: "bar" }）时，对 _id 的查询默认采用严格全量匹配语义：即你传入的查询条件必须与 _id 文档完全一致（字段名、值、顺序均需吻合），否则无法命中任何文档。这正是原代码中 collection.Remove(doc) 返回 Not found 的根本原因——Go 结构体 DocId{Attr1: "foo"} 序列化为 { "attr1": "foo" }，而实际 _id 是 { "attr1": "foo", "attr2": "bar" }，二者不等价。
MongoDB 并不支持对子文档字段进行“部分结构体匹配”，但提供了标准的点号路径语法（dot notation） 来访问嵌套字段。正确做法是将查询条件明确指向 _id.attr1，而非尝试构造一个不完整的 _id 子文档。
✅ 正确写法：使用 bson.M 指定嵌套字段路径
import (
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
// 删除所有 _id.attr1 == "foo" 的文档
err := collection.Remove(bson.M{"_id.attr1": "foo"})
if err != nil {
if err == mgo.ErrNotFound {
// 注意：ErrNotFound 是正常情况（无匹配文档），非致命错误
log.Println("No document found with _id.attr1 = 'foo'")
} else {
log.Fatal("Remove failed:", err)
}
}若需批量删除（推荐用于生产环境），应使用 RemoveAll：
info, err := collection.RemoveAll(bson.M{"_id.attr1": "foo"})
if err != nil {
log.Fatal("RemoveAll failed:", err)
}
log.Printf("Deleted %d documents", info.Removed)⚠️ 关键注意事项
- 结构体绑定失效：Doc 和 DocId 结构体虽能正确映射数据读写，但不能用于部分 _id 查询。bson.M 是动态、灵活的查询首选。
-
索引优化：为提升查询性能，建议为 _id.attr1 创建索引：
collection.EnsureIndex(mgo.Index{Key: []string{"_id.attr1"}}) - 错误处理必须显式：MongoDB 驱动不会自动 panic，务必检查 err，区分 mgo.ErrNotFound（无匹配）与真实错误（如网络异常、权限不足）。
- 避免空值陷阱：若 Attr2 可能为空或缺失，仍不可依赖 omitempty 实现部分匹配——bson.M 路径查询才是唯一可靠方式。
? 总结
MongoDB 的 _id 子文档查询本质是「精确结构匹配」，而非「字段存在性匹配」。绕过该限制的唯一标准方案，是使用点号路径（"_id.attr1"）配合 bson.M 构造查询条件。这一原则同样适用于 Find、Update、Upsert 等所有操作。掌握此机制，可避免大量因误解查询语义导致的静默失败问题。
