必须用CreateIndex而非EnsureIndex，因v1.0+驱动已弃用后者；需用mongo.IndexModel显式配置选项；Explain显示COLLSCAN说明索引未匹配；生产建索引应选低峰期并验证结果。
用 EnsureIndex 还是 CreateIndex？选错就白忙
Go 驱动 v1.0+ 已弃用 EnsureIndex，它不报错但实际不生效；必须用 CreateIndex 才能真正建索引。老项目升级后查询变慢，大概率卡在这儿。
实操建议：
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
-
CreateIndex是幂等操作，重复调用不会报错，适合放在服务启动时执行 - 别在每次请求里建索引——它会阻塞写入，且 MongoDB 会拒绝并发建同一索引
- 如果集合已有大量数据，建索引期间读写可能变慢，建议在低峰期操作或加
{background: true}
mongo.IndexModel 怎么配字段和选项？别只写字段名
只传 bson.D{{"name", 1}} 能建索引，但没法设唯一、过期、稀疏这些关键行为。必须用 mongo.IndexModel 显式声明选项。
常见错误现象：建了索引但 unique: true 不生效，查文档发现没传 Options。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 升序用
1，降序用-1，文本索引用"text"，别混用数字和字符串 - 复合索引字段顺序很重要：前导字段必须出现在查询条件中，否则索引可能被跳过
- 设置过期时间要配
expireAfterSeconds，且字段类型必须是Date或ObjectId - 示例：
model := mongo.IndexModel{ Keys: bson.D{{"status", 1}, {"updated_at", -1}}, Options: options.Index().SetUnique(true).SetBackground(true), }
为什么 Explain 显示没走索引？检查这三处
建完索引但查询还是慢，Explain 返回 stage: COLLSCAN，说明根本没用上。不是索引没建成功，而是匹配不上。
使用场景：排查线上慢查询，尤其涉及嵌套字段、数组、正则时。
实操建议：
- 查询字段名和索引字段名大小写、下划线必须完全一致，MongoDB 区分大小写
- 对数组字段做等值查询（
{"tags": "go"}）能走索引；但用$elemMatch或$all时，要看索引是否覆盖完整路径 - 正则开头带
^可走索引，/go/i这种不带锚点的无法使用索引 - 确保查询用的是
Find而非FindOne（后者也可能因优化器误判跳过索引）
生产环境建索引要注意哪些兼容性细节？
v4.2+ 的副本集默认要求所有节点同时在线才能建索引；v5.0+ 开始支持后台建索引但不阻塞主节点读写——前提是驱动版本 ≥ 1.11 且服务端配置正确。
性能影响：
- 前台建索引会锁表，期间写入失败；后台建索引不锁表，但 CPU 和 I/O 压力明显上升
- 如果集合有 1000 万文档，建一个复合索引可能耗时数分钟，期间监控
db.currentOp()看是否有阻塞 - 别在
mongos上直接建索引——得连到具体 shard 的 primary 节点执行 - 驱动连接字符串里加
?maxPoolSize=20，避免建索引时连接池被占满导致其他请求超时
最常被忽略的一点：建完索引后，别忘了验证 db.collection.getIndexes() 输出里有没有你刚加的那条，以及 key 字段是否和代码里一模一样——多一个空格、少一个负号，都算失效。
