Go连MongoDB卡住或超时主因是DNS解析失败、网络不通或MongoDB未监听预期地址；本地用localhost，Docker需用host.docker.internal或服务名；默认bindIp限制远程连接；连接字符串须含端口；应显式设context超时；filter须用bson.M且字段名大小写敏感；结构体需bson tag映射；ObjectId必须为primitive.ObjectID；全局复用*mongo.Client避免连接池耗尽。
Go 连 MongoDB 时 mongo.Connect 卡住或超时
根本原因通常是 DNS 解析失败、网络不通，或 MongoDB 服务没监听在预期地址。本地开发用 localhost 但 Docker 或云环境里得换 host.docker.internal 或具体 IP；MongoDB 默认不接受远程连接，bindIp 配置不对就会静默拒绝。
- 检查连接字符串是否含端口：本地默认是
mongodb://localhost:27017，少写:27017就连不上 - 用
telnet localhost 27017或nc -zv localhost 27017先验连通性，别等 Go 程序跑起来才排查 -
mongo.Connect默认有 30 秒超时，加context.WithTimeout显式控制，避免协程卡死 - Docker Compose 场景下，Go 服务容器里不能用
localhost指向 MongoDB 容器，得用服务名如mongodb:27017
用 collection.Find 查不到数据但没报错
常见于 filter 构造错误——Go 的 BSON filter 必须用 map[string]interface{} 或 bson.M，直接传 struct 或 map[string]string 会静默忽略字段；另外空 filter（bson.M{}）查全部，但新手常误传 nil，导致返回空游标。
- 查单个字段时别写
bson.M{"name": "foo"}，而要用bson.M{"name": bson.M{"$eq": "foo"}}，否则等于全匹配（某些驱动版本行为不一致） - 字段名大小写敏感，
"Name"和"name"是两个字段，MongoDB 本身不校验 schema - 时间查询容易翻车：
time.Now()是本地时区，MongoDB 存的是 UTC，filter 里要用.UTC()对齐 - 用
FindOne+Decode替代Find+All更省内存，尤其只取一条时
Go 结构体字段映射 MongoDB 字段失败
根本不在意结构体字段名是否和 DB 字段一致，全靠 bson tag 控制。没加 tag、tag 值为空、拼写错误，都会导致 decode 为零值，且无提示。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须显式声明
bson:"field_name"，例如Name string `bson:"name"`，否则驱动按首字母大写导出规则转成"Name"，和 DB 中"name"不匹配 - 嵌套结构体要逐层加 tag，内层字段不会自动继承外层前缀
- 可选字段加
bson:",omitempty"，但注意 bool/0/int 类型的零值也会被跳过，慎用于非空判断场景 - ObjectId 字段类型必须是
primitive.ObjectID，不是string，否则 decode 失败且静默为零值
并发写入时出现 context deadline exceeded 或连接池耗尽
MongoDB Go 驱动默认连接池大小是 100，单 client 实例可复用。高频写入时若每个请求都新建 *mongo.Client，会快速占满文件描述符并触发超时。
立即学习“go语言免费学习笔记（深入）”；
- 全局只初始化一次
*mongo.Client，通过依赖注入或包级变量传递，别在 handler 里反复mongo.Connect - 写操作优先用
InsertOne/UpdateOne，避免InsertMany传超大 slice，它会一次性申请大量内存 - 批量操作用
bulk.Unordered().InsertMany而非串行循环，减少 round-trip 次数 - 确认 MongoDB 是否启用了
maxPoolSize参数限制，生产环境建议设为 50–200，视 QPS 调整
真正麻烦的是 ObjectId 生成和时间戳处理——这两处最容易在不同服务间产生不一致，又很难测出来。别信文档说“自动补”，自己动手才稳。
