Golang MongoDB怎么做增删改查_Golang MongoDB CRUD教程【经典】-Golang-PHP中文网

go连mongodb失败主因是环境配置与隐式状态未校验：连接需带timeout的context并调用ping()验证，权限不足会导致静默失败，_id必须用primitive.objectid类型，过滤器须用bson.m/bson.d，游标须close()，字段映射依赖bson tag而非json tag。

golang mongodb怎么做增删改查_golang mongodb crud教程【经典】

connect() 为什么总超时或 panic？

Go 连 MongoDB 最常见的失败不是驱动没装，而是连接根本没建立成功，client.Ping() 卡住或直接返回 context deadline exceeded。这不是代码写错了，是环境没对上。

默认 URI "mongodb://localhost:27017" 要求 MongoDB 服务正在运行且监听该地址——Windows 上安装后默认不自启，Linux 上得确认 systemctl status mongodb 是 active；macOS 用 Homebrew 安装的可能监听的是 27017，但新版 mongod 默认启用 access control，没配用户会拒绝连接
context.TODO() 和 context.Background() 混用容易出问题：连接阶段必须用带 timeout 的 context，比如 context.WithTimeout(context.Background(), 10*time.Second)，否则 DNS 解析失败时会卡满 30 秒（Go driver 默认）
别跳过 err = client.Ping() ——它才是真正验证连通性的动作，mongo.Connect() 只是启动连接协程，不阻塞也不保证可用

InsertOne() 插入后查不到？_id 字段去哪了

插入成功但 find() 查不到，大概率是文档没进预期数据库/集合，或者 _id 类型不匹配导致查询失效。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

Go driver 不会自动创建 DB 或 Collection，但插入时如果指定的 db.Collection("xxx") 不存在，MongoDB 服务端会静默创建——前提是连接的用户有 dbAdmin 或对应 DB 的 insert 权限；权限不足时插入会静默失败（无报错），日志里只有 auth failed
_id 字段在 Go struct 中必须显式声明为 primitive.ObjectID 类型，不能用 string 或 int，否则 BSON 序列化失败，插入的文档里 _id 变成空对象 {}，后续按 _id 查询必然失败
插入后想立刻拿到 ID，别从原始 struct 读，要从 InsertOneResult.InsertedID 取：
```
res, _ := collection.InsertOne(ctx, doc)
id := res.InsertedID.(primitive.ObjectID)
```

UpdateOne() 找不到文档却不报错？过滤器写法陷阱

UpdateOne() 返回 MatchedCount: 0 却不 panic，新手常误以为“更新成功”，其实是条件根本没命中——MongoDB 的 update 操作天然静默，不匹配就不动，也不提醒你字段名拼错了。

过滤器必须用 bson.M 或 bson.D，不能直接传 map[string]interface{}；Go 的 map 是无序的，而某些操作（如数组位置更新 $[<identifier>]</identifier>）依赖顺序，用 bson.D 更安全
查询 _id 时，字符串必须转成 ObjectID：bson.M{"_id": primitive.ObjectIDHex("64a1b2c3d4e5f67890123456")}，传普通字符串会匹配失败（类型不等）
更新字段用 $set 显式包裹，别直接传整个 struct：
```
filter := bson.M{"name": "燕双鹰"}
update := bson.M{"$set": bson.M{"age": 19}}
```
否则会把整个文档替换成新 struct，丢失其他字段

Find() 返回空 slice 却没报错？游标没关 + context 超时

调用 collection.Find() 后直接 Decode() 或 All() 得到空结果，常见原因不是数据不存在，而是游标没遍历完、context 提前取消、或解码目标类型不对。

Find() 返回 *mongo.Cursor，必须显式 Close()，否则连接池里的 socket 一直占用，大量请求后触发 connection pool is full
用 All() 一次性取全部结果时，若文档量大（比如 >10 万），内存暴涨且易被 context timeout 中断；小数据用 All()，大数据务必用 Next() + 循环
解码到 struct 时，struct 字段 tag 必须是 bson:"field_name"，不是 json:"field_name"；MongoDB 存的是 BSON 字段名，和 JSON tag 无关