mongo.connect 必须配合 context.withtimeout（5–10秒）、合理连接池参数（如 setmaxpoolsize(20)、setminpoolsize(5)）、正确 uri query（如 authsource=admin、connect=direct）及必执行 client.ping 验证，否则易导致启动卡住、连接耗尽或静默通信失败。
mongo.Connect 是 Golang 连接 MongoDB 的入口函数，但直接调用它而不控制上下文、超时和连接池参数，很容易在生产环境里出问题——比如服务启动卡住、高并发下连接耗尽、或偶发性 context deadline exceeded 错误。
连接时必须显式设置 context.WithTimeout
不带超时的 context.TODO() 或 context.Background() 会让 mongo.Connect 无限等待 DNS 解析、TCP 握手或 MongoDB 响应。实际部署中常见现象是：服务启动 hang 住，日志无报错，client.Ping 永远不返回。
正确做法是：
- 用
context.WithTimeout包裹，超时时间建议设为 5–10 秒（比 MongoDB 默认 connectTimeoutMS 略长） -
defer cancel()必须写，否则 context 泄漏会拖慢 GC - 不要复用同一个 context 实例做多次连接尝试——每次
mongo.Connect都该用新 context
连接池参数不设等于自找麻烦
默认连接池大小是 100，但本地开发或小流量服务根本用不到这么多；而高并发服务若不调优，可能因连接数突增触发 MongoDB 的 maxIncomingConnections 限制，出现 connection refused 或 read tcp: i/o timeout。
关键参数要按场景设：
-
SetMaxPoolSize(20)：多数中小服务够用；超过 50 需确认 MongoDB 配置是否允许 -
SetMinPoolSize(5)：避免冷启动时建连延迟，尤其在 Kubernetes Pod 启动后首请求 -
SetConnectTimeout(5 * time.Second)：比外层 context 超时短，让驱动内部更快失败 - 别碰
SetSocketTimeout—— 它已被官方标记为 deprecated，用 context 控制读写超时更可靠
URI 中的 query 参数不能少
只写 "mongodb://localhost:27017" 是最简配置，但上线后常因副本集、认证或 TLS 失败。真实环境至少补上这些 query 参数：
-
?connect=direct：单节点部署时禁用自动发现，避免 driver 尝试连接不存在的 replica set 成员 -
&authSource=admin：指定认证数据库，尤其当用户不在目标 db 创建时 -
&tls=true&tlsCertificateKeyFile=/path/to/tls.pem：启用了 TLS 的集群必须显式声明 -
&serverSelectionTimeoutMS=3000：控制 driver 选主节点的等待上限，防止卡在故障节点探测上
漏掉 authSource 会导致 Unauthorized 错误；漏掉 connect=direct 在单机模式下可能引发 no reachable servers 报错，尽管 mongod 正在运行。
client.Ping 不是可选步骤
很多人跳过 client.Ping，觉得 mongo.Connect 成功就代表连上了。但 mongo.Connect 只建立 TCP 连接并完成 SASL 认证，不验证是否能执行命令。真正的问题往往出现在第一次 InsertOne 或 Find 时才暴露。
务必在 Connect 后立刻 Ping：
- 用同一个 context（别用新 context，否则超时逻辑不一致）
- 传
nil作为readPreference参数即可，不用额外构造 - 如果 Ping 失败，
err通常是server selection error或connection refused，比后续操作失败更容易定位
没做 Ping 的服务，在容器重启后可能跑了一小时才因第一条写入失败而告警，而不是启动时就崩掉。
真正的坑不在语法，而在连接建立后的“静默状态”——driver 已连上，但无法通信；参数看似生效，却因 MongoDB 版本或部署拓扑被忽略；Ping 通过了，但集合权限没开，导致后续所有操作都 not authorized。把这些点对齐，才能让 mongo.Connect 不是起点，而是稳态的开始。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
