Echo 不参与 MongoDB 集成，成败取决于 mongo-go-driver 初始化、context 传递和 bson tag；必须用带超时的 context 连接、及时 Ping 验证、严格校验结构体 tag、正确关闭游标、遵循 UpdateOne 参数顺序及 filter/update 类型规范。
直接说结论：Echo 框架本身不参与 MongoDB 集成，真正决定成败的是 mongo-go-driver 的初始化方式、context 传递时机和结构体 bson tag 的准确性——Echo 只负责把请求 context 传给你，剩下的全得自己扛。
mongo.Connect 必须配带 deadline 的 context，不能用 context.Background()
很多人在 Echo 启动时写 mongo.Connect(context.Background(), ...)，服务上线后偶发卡死或 goroutine 泄漏。这是因为 driver 默认会无限等待 DNS 解析、TCP 握手或认证响应。
- 必须用
context.WithTimeout(context.Background(), 10*time.Second)包裹，超时设为 10 秒较稳妥（比 MongoDB 默认 connectTimeoutMS=30s 短，但留出 ping 验证余量） - 调用完
mongo.Connect后立刻defer cancel()，否则 context 泄漏会拖慢 GC - 别复用同一个 context 实例做多次连接尝试——每次
mongo.Connect都该用新 context - 连接后务必调用
client.Ping(ctx, readpref.Primary())，传readpref.Primary()而不是nil，否则副本集环境下可能连到 secondary 并返回 stale 数据
结构体字段必须加 bson tag，拼错一个字母 Decode 就全为零值
Go 驱动完全不校验 schema，字段映射失败不会报错，只会把 struct 字段设为零值。常见现象是 FindOne() 返回非 nil result，但解码后所有字段都是空字符串、0 或 nil。
-
_id字段类型必须是primitive.ObjectID，且 tag 写成bson:"_id,omitempty"（下划线不能少） - 时间字段必须是
time.Time类型，tag 写成bson:"created_at"，不能是字符串或 int64 - 嵌套结构体要逐层加 tag，内层字段不会继承外层前缀；比如
User.Profile.Name对应的 tag 是bson:"profile"和bson:"name"，不是bson:"profile.name" - 密码含
/、@、:等字符时，URI 必须用url.PathEscape()编码，否则解析失败，错误信息模糊（如invalid URI）
Find() 游标必须 Close，否则 goroutine 和内存永不释放
Echo 中常有人在 handler 里调用 collection.Find() 后直接 return，忘了关游标。这会导致底层网络连接和缓冲区一直占用，QPS 上去后迅速耗尽连接池。
立即学习“go语言免费学习笔记（深入）”；
- 必须在 handler 开头就声明
ctx := c.Request().Context()，并传给Find()和cursor.Close() - 写成
defer cursor.Close(ctx)，而不是defer cursor.Close(context.Background()) - 遍历游标必须先
cursor.Next(ctx)，再cursor.Decode(&v)；跳过Next()直接Decode()会 panic - 高并发场景慎用
cursor.All()转切片，容易 OOM；优先流式处理（for cursor.Next() { ... }）
UpdateOne 的 filter 和 update 参数顺序不能颠倒
这是个低级但高频的错误：把 UpdateOne(ctx, update, filter) 写反，结果是“没报错、没更新、也没提示”，因为 driver 把错误的 update 当成 filter 解析了，然后默默匹配不到任何文档。
- 正确顺序永远是
collection.UpdateOne(ctx, filter, update, opts) -
filter必须是bson.M或bson.D，不能是普通map[string]interface{}（虽能编译，但时间/二进制字段会出问题） -
update必须带操作符，如bson.M{"$set": bson.M{"name": "Alice"}}，不能直接传bson.M{"name": "Alice"} - 如果用结构体构造 update，确保字段也加了 bson tag，否则
$set内部字段无法序列化
最易被忽略的其实是 primitive.M 和 map[string]interface{} 的混用——它们看起来一样，但驱动内部做了字段顺序、nil 处理、时间/二进制等类型的特殊编码，混用会导致写入字段丢失或时间戳变零值。
