使用GORM原生查询时无法预加载关联外键的问题咨询

问题原因分析 #

1. Raw查询不支持GORM的Preload机制 #

GORM的Preload（包括clause.Associations）是ORM层专属特性，仅对GORM自动生成的查询（如Find、Where等链式调用）生效。当使用Raw执行自定义SQL时，GORM仅负责将查询结果直接映射到结构体字段，不会主动触发关联数据的查询逻辑，因此即使添加Preload也无法加载Bank关联数据。

2. 模型关联标签配置错误 #

你的BankAccount结构体中Bank字段的外键标签存在错误：

Bank          *Bank     `gorm:"foreignKey:BankAccountId" json:"bank"`

foreignKey需要指定当前结构体中用于关联的外键字段，也就是BankId，正确的标签应该是：

Bank          *Bank     `gorm:"foreignKey:BankId" json:"bank"`

虽然Find方法可能自动识别了关联关系，但标签不规范会导致场景兼容性问题，必须修正。

解决办法 #

办法一：优先使用GORM链式查询（推荐） #

如果不需要自定义原生SQL，直接用GORM的链式查询即可自动预加载关联：

var bankAccounts []BankAccount
db.Preload(clause.Associations).Find(&bankAccounts)

这就是你之前能正常获取Bank数据的方式，保持使用即可。

办法二：原生SQL+手动关联加载（必须用Raw时） #

如果业务需求必须使用原生SQL查询BankAccount，可以手动分步骤加载关联数据：

// 1. 执行原生查询获取BankAccount列表
var bankAccounts []BankAccount
db.Raw("select * from bank_account").Scan(&bankAccounts)

// 2. 提取所有需要查询的BankId
var bankIds []uuid.UUID
for _, acc := range bankAccounts {
    bankIds = append(bankIds, acc.BankId)
}

// 3. 批量查询Bank数据（避免N+1查询）
var banks []Bank
db.Where("id IN ?", bankIds).Find(&banks)

// 4. 构建Bank映射表，快速匹配关联
bankMap := make(map[uuid.UUID]*Bank)
for i := range banks {
    bankMap[banks[i].ID] = &banks[i]
}

// 5. 将Bank数据关联到对应的BankAccount
for i := range bankAccounts {
    bankAccounts[i].Bank = bankMap[bankAccounts[i].BankId]
}

办法三：原生SQL JOIN查询一次性获取所有数据 #

如果是一对一关联，可以通过JOIN语句一次性查询bank_account和banks表的数据，再映射到结构体：

var bankAccounts []struct {
    BankAccount
    BankName    string `json:"bank.name" gorm:"column:bank_name"`
    BankAddress string `json:"bank.address" gorm:"column:bank_address"`
    // 其他Bank字段按需添加，注意通过gorm标签映射列名
}

db.Raw(`
    SELECT ba.*, b.name as bank_name, b.address as bank_address
    FROM bank_account ba
    JOIN banks b ON ba.bank_id = b.id
`).Scan(&bankAccounts)

这种方式需要手动处理字段映射，适合简单关联场景。

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