GORM 的 Preload 默认是分步查询:先查主表,再用主表 ID 批量查关联表;它非 JOIN 也非简单 N+1,适合只读场景,避免笛卡尔积与意外写操作。

预加载在 GORM 中本质是 JOIN 查询还是 N+1?
不是 JOIN,也不是简单 N+1 —— GORM 的 Preload 默认走的是 **分步查询(separate queries)**:先查主表,再用主表 ID 批量查关联表。这意味着它天然适合只读场景,不会意外触发关联数据的写操作,也避开了 JOIN 可能导致的笛卡尔积膨胀问题。
但要注意:如果你用 Joins(比如 Joins("User")),那才是真 JOIN,且 GORM v2+ 默认不支持对 JOIN 结果赋值到 struct 关联字段(会静默失败或字段为空),容易误以为“预加载生效了”,其实没加载进内存。
怎么写一个安全、可复用的只读预加载链?
核心是三点:显式控制加载层级、避免隐式 save/update、禁用自动更新时间戳。例如查订单及其用户、地址、商品快照:
var orders []Order
err := db.Preload("User", func(db *gorm.DB) *gorm.DB {
return db.Select("id, name, email") // 明确字段,防敏感信息泄露
}).Preload("Address", func(db *gorm.DB) *gorm.DB {
return db.Select("id, order_id, province, city").Where("status = ?", "active")
}).Preload("Items.Product", func(db *gorm.DB) *gorm.DB {
return db.Select("id, name, price").Clauses(clause.Locking{Strength: "SHARE"}) // 共享锁,只读不阻塞写
}).Find(&orders).Error
- 每个
Preload后的func是独立子查询,互不影响,可分别加Select/Where/Clauses -
Product嵌套在Items下,必须写成"Items.Product",不能拆成两个Preload("Items")+Preload("Product")(后者无效) -
clause.Locking在 PostgreSQL/MySQL 8.0+ 有效,告诉数据库“我只读”,避免被其他事务升级为排他锁
为什么有时候 Preload 查不到关联数据?常见掉坑点
不是代码写错,而是模型定义或查询条件不匹配:
立即学习“go语言免费学习笔记(深入)”;
- 外键字段名不一致:比如
Orderstruct 里写了UserID uint,但数据库字段是user_id_int,GORM 找不到关联依据 → 检查foreignKeytag,如UserID uint `gorm:"foreignKey:UserIDInt"` - 预加载路径大小写敏感:
Preload("user")失败,必须是Preload("User")(匹配 struct 字段名,非数据库列名) - 主表查询用了
Limit(1)但没Order:GORM 分步查询时,第二步用IN (?)传 ID 列表,如果主表结果无序且没排序,可能导致关联数据顺序错乱(虽不影响正确性,但调试时易误判为空) - 关联 struct 字段是指针类型(
*User)但没初始化:GORM 不会自动 new,会导致User为 nil 而不是空 struct —— 只读场景建议用值类型(User User)或确保初始化
想强制走 JOIN 查询时该怎么处理?
仅当确定数据量小、无笛卡尔积风险、且需要 WHERE 过滤关联字段时才考虑。GORM 不提供“预加载式 JOIN”,得手动写:
var results []struct {
Order Order
User User
Address Address
}
err := db.Table("orders").
Select("orders.*, users.name as user_name, addresses.city").
Joins("left join users on users.id = orders.user_id").
Joins("left join addresses on addresses.order_id = orders.id").
Where("orders.status = ?", "paid").
Scan(&results).Error
注意:这种写法下,results 是匿名结构体切片,无法直接复用已有 model 方法;User 和 Address 字段不会自动绑定到嵌套 struct,得靠字段别名 + 手动映射。真正需要只读关联查询时,Preload 的语义清晰性和安全性远高于硬写 JOIN。
最易被忽略的一点:预加载的子查询默认不继承主查询的 Scopes 或 Session 配置,比如你主查询用了 db.Session(&gorm.Session{DryRun: true}),Preload 里的子查询依然会真实执行 —— 如果要做完整只读模拟,每个 Preload 内部都得单独加 Session。


















