mongo.Connect必须用context.WithTimeout(10秒)包裹并defer cancel(),URI需从环境变量读取且含authSource,client.Ping须用新context,结构体字段必须正确标注bson tag,游标必须defer Close。

Fiber 本身不连接数据库,所有连接逻辑由你用 driver 或 ORM 显式初始化;漏设超时、连接池或环境变量读取方式,上线后必连不上或 OOM。
mongo-go-driver 连接必须带 context.WithTimeout
常见错误是写成 client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri)),这会让连接卡死或 panic。生产环境必须用带超时的 context 包裹 mongo.Connect() 和后续的 client.Ping():
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)- 调完
mongo.Connect()后立刻defer cancel() -
client.Ping()必须传新 context(不能复用 Connect 时的),否则超时无效 - URI 必须从环境变量读:
os.Getenv("MONGODB_URI"),禁止硬编码localhost或密码
gorm.Open() 后必须手动调 db.DB().SetMaxOpenConns()
只写 gorm.Open(mysql.Open(dsn), &gorm.Config{}) 是不够的——默认 *sql.DB 的 MaxOpenConns=0(无上限)、MaxIdleConns=2,压测时直接出现 dial tcp: i/o timeout 或连接耗尽:
- 初始化后立刻执行:
db.DB().SetMaxIdleConns(10)、db.DB().SetMaxOpenConns(50) - 必须设
db.DB().SetConnMaxLifetime(1 * time.Hour),避免中间件(如 RDS Proxy)提前断连导致僵死连接堆积 -
SetConnMaxLifetime参数类型是time.Duration,不是字符串,写成"1h"会编译失败
结构体字段必须用 bson tag,不是 json
Go 结构体映射 BSON 文档完全依赖 bson tag;漏写、拼错或类型不匹配,FindOne() 就返回空值但不报错,是最隐蔽的 bug 来源:
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
- ID 字段必须写成:
ID primitive.ObjectID `bson:"_id,omitempty"`(下划线不能少) - 时间字段类型必须是
time.Time,tag 写成bson:"created_at",不能是字符串或int64 - 嵌套结构体每一层都要加
bsontag,否则子字段不会被序列化/反序列化 - 手动构造
bson.M查询时,value 类型必须和数据库字段一致,比如"age": 25不能写成"age": "25"
游标必须 defer cursor.Close(ctx),且 ctx 是请求生命周期 context
Find() 返回的 *mongo.Cursor 底层持有网络连接和缓冲区,不 Close() 就会泄漏 goroutine 和内存,高并发下很快 OOM:
- 必须写
defer cursor.Close(c.Context()),这里的c.Context()是 handler 入参的请求 context,不是全局context.Background() - 遍历前必须先调
cursor.Next(),再cursor.Decode();跳过Next()直接Decode()会 panic - 批量结果可用
cursor.All()转切片,但要注意内存占用;流式处理建议用Next()+Decode()循环
最常被忽略的是:连接池参数和 bson tag 的一致性——前者决定能不能连上,后者决定连上了能不能读到数据;两个环节任一出错,现象都是“没报错但查不到东西”。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










