mongo.connect() 默认无超时，需用 context.withtimeout 控制；findone() 查无结果返回 nil 但 err 为 nil；primitive.m 不可替换 map[string]interface{}；insertmany() 不填充原结构体 _id；连接池应全局复用。
mongo.Connect() 会卡住或超时？别只怪网络，先看 context
Go 驱动的 mongo.Connect() 默认不设连接超时，一旦 DNS 解析慢、防火墙拦截、Atlas 连接字符串填错（比如漏了 @ 或多写了空格），它就一直等下去，直到操作系统 TCP 超时（通常 2–3 分钟）。这不是 bug，是设计：驱动把“连接建立”这个动作完全交给你用 context 控制。
- 必须用带 deadline 的
context，比如context.WithTimeout(context.Background(), 10*time.Second)；不用context.Background()直接传进去，等于放弃控制权 - 超时后
err是context.DeadlineExceeded，不是connection refused—— 别误判为服务没起来 - 连接字符串里的
connectTimeoutMS只影响初始握手，不覆盖mongo.Connect()的 context 超时，两者要配合用
FindOne() 返回 nil 却不报错？这是正常行为，不是 bug
Go 驱动严格区分“查无结果”和“操作失败”。FindOne() 找不到文档时，返回 nil *mongo.SingleResult，但 err 仍是 nil。很多人直接判 if result == nil 就 panic，结果一查不到就崩。
- 正确流程：先检查
err是否非 nil（真出错了）；再调result.Err()看是否为mongo.ErrNoDocuments（查无结果） -
result.Decode(&v)前必须确保result != nil且result.Err() == nil，否则 runtime panic: invalid memory address - 别用
if result == nil { /* 失败 */ }，这会把“没找到”当成“连接失败”处理
primitive.M 和 map[string]interface{} 能互换吗？不能，混用必丢字段
看起来都是 map[string]interface{}，但 primitive.M 是驱动内部定制类型，做了字段顺序保留、nil 值特殊处理、time.Time 自动转 BSON Date 等。用原生 map 传给 InsertOne() 或 UpdateOne()，时间变零值、二进制字段消失、甚至整个文档写入失败。
- 所有查询、更新、插入一律用
primitive.M{"name": "alice", "age": 30} - 结构体字段必须加
bson:"name"tag，否则驱动按 Go 字段名（大写首字母）映射，BSON 里找不到对应 key -
time.Time字段类型必须保持为time.Time，别转成 string，否则驱动不会序列化为 BSON Date 类型
InsertMany() 不填 _id？那你就拿不到刚插进去的 ID 对应哪条数据
InsertMany() 返回的是新生成的 _id 列表，但它**不会反向填充你传入切片中每个结构体的 _id 字段**。如果你没提前赋值，插入后根本无法知道哪个 _id 对应原始数据里的哪一条。
- 安全做法：插入前手动赋值，
doc.ID = primitive.NewObjectID()，再传进切片 - 如果依赖驱动自动生成，又想事后关联，得自己用返回的
InsertManyResult.InsertedIDs按索引对齐原始数据（注意：它是map[int]interface{}，key 是 slice 下标） - 批量失败默认全回滚；如需部分成功，加
options.InsertMany().SetOrdered(false)
最常被忽略的其实是连接池复用——别在 HTTP handler 里每次新建 mongo.Client，一个进程配一个全局 client 就够了；minPoolSize 设为 5–10 能缓解冷启动延迟，但设太高会撑爆 Atlas 免费集群的连接数上限。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
