GORM 连数据库前必须初始化连接,否则调用 Create 或 First 会 panic;需用 gorm.Open 初始化并检查 error,配置连接池、避免零值覆盖、慎用 Where 动态条件、区分 Save 与 Updates 行为、注意软删除和 AutoMigrate 局限性。

用 GORM 连数据库前必须初始化连接
不初始化 gorm.Open 就调 Create 或 First,会 panic 报 invalid memory address or nil pointer dereference。常见错误是只声明了 *gorm.DB 变量但没赋值,或者初始化失败后没检查 error。
实操建议:
- 用
gorm.Open时传入具体驱动(如mysql.Open或sqlite.Open),别直接传字符串 - 务必检查返回的
error,哪怕只是log.Fatal(err),否则后续所有操作都静默失败 - 推荐用
gorm.Config{SkipDefaultTransaction: true}避免隐式事务开销(尤其在高频写场景) - 连接池设置别漏:
sqlDB, _ := db.DB(); sqlDB.SetMaxOpenConns(10); sqlDB.SetMaxIdleConns(5)
Create 插入数据时主键和零值要小心
默认情况下,GORM 会把结构体字段零值(0、""、nil)也写进 SQL —— 即使数据库字段有默认值或允许 NULL,也可能被覆盖。比如 Age int 字段为 0,Create 会插 age = 0 而不是跳过。
实操建议:
- 用指针类型字段(如
*int、*string)可区分“未设置”和“设为零”,GORM默认跳过 nil 指针 - 加
gorm:"default:CURRENT_TIMESTAMP"标签让数据库控制默认值,再配合gorm:"null"允许为空 - 批量插入用
CreateInBatches,别用循环Create,性能差一个数量级 - 想忽略某字段插入?加
gorm:"-:"标签,比如Status int `gorm:"-:"`
Where 查询容易写错条件逻辑
Where("id = ?", id) 看似没问题,但一旦 id 是 0 或空字符串,可能查出意外结果;更危险的是用 Where(map[string]interface{}{"name": name}) —— 如果 name == "",就会生成 WHERE name = '',而不是忽略该条件。
实操建议:
- 动态条件用链式
if判断:tx := db; if name != "" { tx = tx.Where("name LIKE ?", "%"+name+"%") } - 主键查询优先用
First/Take/Find的变体,比如db.First(&user, 123)比Where("id = ?", 123).First()更安全 - 模糊匹配别手写
%,用Like方法:Where("name", "like", "%john%")(GORM v2.2+ 支持) - 查不到记录时,
First返回gorm.ErrRecordNotFound,别用err == nil判定成功
Save 和 Updates 修改行为完全不同
Save 是全量更新:它会把结构体所有字段(包括零值)都写进 SQL;而 Updates 默认只更新非零值字段 —— 但这不是靠反射判断“是否设置”,而是靠字段值本身。比如 user.Age = 0 后调 Updates,age 字段不会被更新(除非显式传 map)。
实操建议:
- 想局部更新且允许写零值?用
Updates(map[string]interface{}{"age": 0, "name": "tom"}) - 想全量覆盖(含零值)且避免 SQL 注入?用
Select("*").Updates,但注意这会覆盖所有字段,包括你没改过的 -
Delete默认是软删除(加deleted_at),真删要用Unscoped().Delete,否则查不到刚删的记录 - 修改前最好先
First查一次,避免Save把不存在的 ID 当新记录插入(GORM 会按主键是否存在决定 INSERT/UPDATE)
最常被忽略的是:GORM 的 AutoMigrate 不会删字段、不改类型、不处理索引变更,上线前务必人工核对表结构;还有事务里混用多个 db 实例(比如从不同函数传进来的 *gorm.DB)会导致事务失效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











