必须用createindex而非ensureindex,因v1.0+驱动已弃用后者;需用mongo.indexmodel显式配置选项;explain显示collscan说明索引未匹配;生产建索引应选低峰期并验证结果。

用 EnsureIndex 还是 CreateIndex?选错就白忙
Go 驱动 v1.0+ 已弃用 EnsureIndex,它不报错但实际不生效;必须用 CreateIndex 才能真正建索引。老项目升级后查询变慢,大概率卡在这儿。
实操建议:
-
CreateIndex是幂等操作,重复调用不会报错,适合放在服务启动时执行 - 别在每次请求里建索引——它会阻塞写入,且 MongoDB 会拒绝并发建同一索引
- 如果集合已有大量数据,建索引期间读写可能变慢,建议在低峰期操作或加
{background: true}
mongo.IndexModel 怎么配字段和选项?别只写字段名
只传 bson.D{{"name", 1}} 能建索引,但没法设唯一、过期、稀疏这些关键行为。必须用 mongo.IndexModel 显式声明选项。
常见错误现象:建了索引但 unique: true 不生效,查文档发现没传 Options。
实操建议:
- 升序用
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 字段是否和代码里一模一样——多一个空格、少一个负号,都算失效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











