如何通过GORM框架掌握Golang数据库编程方法-Golang-PHP中文网

GORM模型字段标签是决定表结构和行为的核心配置，必须显式标注primaryKey、unique、default等关键约束，而非可选装饰；例如ID非标准命名需gorm:"primaryKey"，Email需not null+unique防空字符串重复，time.Time默认值须用CURRENT_TIMESTAMP且依赖parseTime=True。

如何通过gorm框架掌握golang数据库编程方法

直接上手 GORM 就能写数据库逻辑，但真正掌握它不靠背 API，而在于理解模型定义、连接生命周期、迁移时机和查询边界这四个实际卡点。

模型字段标签怎么写才不会漏掉关键约束

字段标签不是可选装饰，而是决定表结构和行为的核心配置。比如 ID 字段没加 gorm:"primaryKey"，GORM 会默认用 id 字段，但若你结构体里叫 UserID 就查不到主键；Email 字段只写 unique 不加 not null，MySQL 会允许空字符串插入两次，违反业务唯一性预期。

gorm:"primaryKey" 必须显式标注，尤其当主键名不是 ID 或类型不是 uint
gorm:"uniqueIndex" 和 gorm:"unique" 效果不同：前者建唯一索引，后者只在 GORM 层校验（可能绕过）
gorm:"default:0" 对数字类型有效，但对 time.Time 要用 gorm:"default:CURRENT_TIMESTAMP"，且需配合 CreatedAt/UpdatedAt 字段名或自定义标签
SQLite 不支持 ALTER COLUMN ... TYPE，所以首次 AutoMigrate 后改字段类型（如 string → int）不会生效

Open 连接后为什么 db.QueryRow 总是返回 ErrNoRows

这不是 SQL 写错了，而是 GORM 的 *gorm.DB 实例本身不直接暴露 database/sql 的原生方法。调用 db.Raw("SELECT ...").Row() 才等价于 db.QueryRow；直接用 db.QueryRow 会 panic 或静默失败，因为 db 是 GORM 封装对象，不是 *sql.DB。

Golang Uber Dig

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

下载

需要原生 SQL 时，统一走 db.Raw("...").Scan(&v) 或 db.Raw("...").Rows()
db.Session(&gorm.Session{NewDB: true}) 可获取底层 *sql.DB，但仅限特殊场景（如连接池健康检查）
连接字符串里的 parseTime=True 必须开启，否则 time.Time 字段反序列化成零值
MySQL DSN 中的 loc=Local 若缺失，CreatedAt 可能存成 UTC 时间却按系统时区解析，导致时间偏移

AutoMigrate 为什么有时不创建外键或索引

AutoMigrate 只保证字段存在和基本类型匹配，不处理约束同步。比如你给 User 结构体加了 gorm:"foreignKey:UserID" 关联标签，但没在 Order 表里定义 UserID uint 字段，GORM 不会自动加该字段，更不会建外键约束——它只“迁字段”，不“补逻辑”。

外键必须由关联字段 + 显式约束共同触发：UserID uint `gorm:"index"` + gorm:"foreignKey:UserID;constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"
SQLite 默认禁用外键（即使写了 constraint），需手动执行 PRAGMA foreign_keys = ON
AutoMigrate 不会删除已存在但模型中已移除的字段或索引，残留字段可能干扰后续查询
PostgreSQL 迁移时若字段类型变更（如 varchar(50) → varchar(100)），需确保数据库支持 ALTER COLUMN TYPE，否则报错

预加载 Preload 为什么查不出关联数据

根本原因是 GORM 的 Preload 默认只做一次 JOIN 查询，如果关联表有 WHERE 条件或分页，它会失效。比如 db.Preload("Orders").First(&user) 能查出订单，但 db.Preload("Orders", "status = ?", "paid").First(&user) 在 v1.9.x 之前版本会忽略条件，v2 后需用 Joins 替代。

Preload 的条件过滤必须用闭包：db.Preload("Orders", func(db *gorm.DB) *gorm.DB { return db.Where("status = ?", "paid") })
一对多预加载后，若主记录为空（如 First 查不到用户），Orders 切片不会被初始化，直接访问会 panic
嵌套预加载（如 Preload("Orders.Items")）要求中间模型也定义了正确关联标签，否则第二层为空
MySQL 5.7+ 开启 ONLY_FULL_GROUP_BY 时，带 Preload 的 Group 查询可能报错，需显式指定 SELECT 字段