Gorm v1.9.16中Preload关联查询出现列名歧义错误的解决求助

Gorm v1.9.16在预加载关联时，自动生成的WHERE子句中使用了无表前缀的id字段，而你的关联查询JOIN了employees表，导致数据库无法识别该id所属表，触发字段歧义错误。

方案1：调整结构体主键字段名（推荐） #

将结构体主键字段名改为ID，保留gorm标签映射到数据库实际列名，让Gorm正确识别主键，避免生成错误的id引用：

type Employee struct {
    ID                int64  `gorm:"primary_key;column:employee_id"`
    EmployeeCode      string `gorm:"column:employee_code"`
    FirstName         string `gorm:"column:first_name"`
    LastName          string `gorm:"column:last_name"`
    DesignationID     int64  `gorm:"column:designation_id;"`
    Designation       *Designation `gorm:"foreignkey:DesignationID"`
}

type Designation struct {
    ID                int64  `gorm:"primary_key;column:designation_id"`
    DesignationName   string `gorm:"column:designation_name"`
}

修改后Gorm会自动使用正确的列名生成WHERE条件，消除字段歧义。

方案2：指定预加载的主键列名 #

若不想修改结构体，可在Preload回调中通过Set方法明确指定预加载使用的主键列名，替换Gorm默认的id：

func GetEmployee(id int64) (*Employee, error) {
    db := connection.GetConn()
    defer db.Close()

    employee := &Employee{}
    err := db.Model(&Employee{}).
        Where("employee_id = ?", id).
        Preload("Designation", func(db *gorm.DB) *gorm.DB {
            return db.Set("gorm:preload:primary_key", "designation_id").
                Joins("INNER JOIN employees ON employees.designation_id = designations.designation_id").
                Order("employees.first_name DESC")
        }).
        Find(employee).Error
    return employee, err
}

此配置会让Gorm生成designation_id IN (...)的WHERE条件，明确指向designations表的主键列。

方案3：手动构建预加载的WHERE条件 #

直接在Preload回调中编写带表前缀的WHERE条件，覆盖Gorm自动生成的歧义条件：

func GetEmployee(id int64) (*Employee, error) {
    db := connection.GetConn()
    defer db.Close()

    employee := &Employee{}
    // 先查询目标Employee，获取关联的DesignationID
    if err := db.Where("employee_id = ?", id).Find(employee).Error; err != nil {
        return nil, err
    }

    // 预加载时指定明确的WHERE条件
    err := db.Model(employee).
        Preload("Designation", func(db *gorm.DB) *gorm.DB {
            return db.Joins("INNER JOIN employees ON employees.designation_id = designations.designation_id").
                Where("designations.designation_id = ?", employee.DesignationID).
                Order("employees.first_name DESC")
        }).
        Find(employee).Error
    return employee, err
}

方案4：改用关联查询替代预加载 #

若业务允许，直接使用Joins进行关联查询，避免预加载时的自动条件生成问题：

func GetEmployee(id int64) (*Employee, error) {
    db := connection.GetConn()
    defer db.Close()

    employee := &Employee{}
    err := db.Joins("JOIN designations ON employees.designation_id = designations.designation_id").
        Where("employees.employee_id = ?", id).
        Order("employees.first_name DESC").
        Find(employee).Error
    return employee, err
}

注：若Gorm无法自动映射关联字段到Designation属性，可配合Select显式指定查询字段。

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