GORM 中正确实现一对多关联查询：Preload 避免 N+1 问题-Golang

在 gorm 中实现 place 与 town 的关联查询时，需正确定义外键（如 townid）并使用 preload 加载关联数据，避免低效的 n+1 查询，仅通过两次 sql 即可获取完整嵌套结果。

要在 Go 中使用 GORM 正确加载 Place 及其所属 Town 的完整信息，关键在于两点：结构体字段定义规范 和 关联查询方式选择。默认情况下，GORM 不会自动识别外键关系，因此必须显式声明外键字段。

✅ 正确的结构体定义

type Place struct {
    ID       int    `gorm:"primaryKey"`
    Name     string
    TownID   int    `gorm:"index"` // 必须显式声明外键，并建议加索引提升 JOIN 性能
    Town     Town   `gorm:"foreignKey:TownID"` // 明确指定外键映射
}

type Town struct {
    ID   int    `gorm:"primaryKey"`
    Name string
}

⚠️ 注意：TownID 字段不可省略；若缺失，GORM 将无法建立关联，Preload 或 Related 均无效。

✅ 推荐方案：使用 Preload 实现高效 JOIN 式加载

var places []Place
if err := db.Preload("Town").Find(&places).Error; err != nil {
    log.Fatal(err)
}
fmt.Printf("%+v\n", places)
// 输出示例：
// [{ID:1 Name:"Place1" TownID:1 Town:{ID:1 Name:"Town1"}} 
//  {ID:2 Name:"Place2" TownID:1 Town:{ID:1 Name:"Town1"}}]

该方式生成 仅 2 条 SQL 查询：

• SELECT * FROM places
• SELECT * FROM towns WHERE id IN (1)
  完美规避 N+1 问题，无论数据量增长至千级或万级，查询次数恒为 2。

❌ 不推荐方案：循环调用 Related（引发 N+1）

db.Find(&places)
for i := range places {
    db.Model(&places[i]).Related(&places[i].Town) // 每次触发一次 SELECT FROM towns
}

此写法虽能获得预期结果，但每条 Place 都发起独立查询——100 个 Place 就产生 101 次数据库交互，严重拖慢性能，生产环境应严格禁止。