GORM一对多关联查询优化：如何避免N+1循环查询提升性能

1. 先修正模型关联标签配置 #

首先需要在模型中显式声明关联关系，让GORM可以正确识别两表的外键映射规则：

// User1 对应querydata表
type User1 struct {
    QueryID uint   `gorm:"primaryKey;column:query_id" json:"query_id"`
    // 其余表字段省略
    Input   []User2 `gorm:"foreignKey:QueryID;references:QueryID" json:"input"`
}

// User2 对应tabledata表
type User2 struct {
    ID      uint   `gorm:"primaryKey"`
    QueryID uint   `gorm:"column:query_id" json:"-"` // 外键字段，序列化时可隐藏
    // 其余表字段省略
}

// 显式指定表名，适配非GORM默认命名规则的表
func (User1) TableName() string {
    return "querydata"
}
func (User2) TableName() string {
    return "tabledata"
}

• foreignKey:QueryID：指定关联的子表（User2）中用来关联的外键字段名
• references:QueryID：指定父表（User1）中用来关联的主键字段名

2. 使用Preload预加载解决N+1问题 #

GORM的Preload预加载功能是专门处理关联查询N+1问题的方案，原理为：

1. 第一次查询符合条件的所有User1数据
2. 自动收集所有User1的query_id列表，用IN查询第二次查询所有匹配的User2数据
3. 自动将User2按query_id分组挂载到对应User1的Input字段中

总查询次数仅为2次，远优于循环查询的N+1次，查询代码示例：

var user1List []User1
// 预加载Input关联，直接查询即可
err := db.Preload("Input").Find(&user1List).Error
if err != nil {
    // 自定义错误处理逻辑
}

如果需要给关联的User2加过滤、排序等条件，可以给Preload传闭包：

err := db.Preload("Input", func(db *gorm.DB) *gorm.DB {
    // 示例：只查询状态正常的User2，按创建时间倒序
    return db.Where("status = ?", 1).Order("create_time DESC")
}).Find(&user1List).Error

如果父表User1本身有过滤条件，Preload会自动仅收集符合条件的query_id查询关联数据，不会产生冗余查询：

// 示例：仅查询近7天创建的User1，同时关联对应Input
err := db.Preload("Input").Where("create_time > ?", time.Now().AddDate(0,0,-7)).Find(&user1List).Error

3. 之前直接用Joins返回全量数据的原因 #

Joins是联表查询，返回的是两表笛卡尔积结果，如果不额外做分组映射处理，GORM不会自动将子项分组挂载到对应父模型下，因此会拿到全量的User2数据。一对多关联的N+1场景下优先使用Preload即可，无需额外写复杂的联表分组逻辑。

内容的提问来源于stack exchange，提问作者Khushi