GORM嵌入结构体跨表预加载报错：column users.email_id不存在

问题原因 #

1. 字段-列名映射不匹配：User结构体的EmailID字段未指定gorm列标签，Gorm默认将驼峰命名转为蛇形email_id，但你的users表中不存在该列，导致SQL查询报错。
2. 关联逻辑配置错误：你通过嵌入UserEmail实现关联，但UserEmail并非数据库映射模型，且预加载时未手动指定users与emails的关联条件，Gorm自动生成的关联逻辑不符合实际表结构。

修复方案 #

1. 修正User结构体的字段标签 #

给EmailID添加gorm标签，指定其对应users表中的实际外键列名（替换示例中的email_id为你数据库的真实列名）：

// 除嵌入UserEmail外与数据库users表结构一致
type User struct {
    ID      string `json:"id" gorm:"column:id"`
    EmailID string `json:"-" gorm:"column:email_id"` // 明确指定数据库列名

    *UserEmail `json:",inline"` // 移除gorm关联标签，避免干扰
}

// 与数据库email表结构不一致
type UserEmail struct {
    UserEmailID string `json:"-"`
    UserEmail   string `json:"user_email"`
}

// 与数据库email表结构一致
type Email struct {
    ID    string `json:"id"`
    Email string `json:"email"`
}

2. 调整预加载逻辑 #

手动指定关联条件，让Gorm用users表的外键关联emails表的主键，同时完成字段别名映射：

err = db.ORM.Model(&User{}).
    Preload("UserEmail", func(db *gorm.DB) *gorm.DB {
        return db.Model(&Email{}).
            Select("id as user_email_id, email as user_email").
            Where("emails.id = users.email_id") // 手动关联两表
    }).
    Find(&resp).Error

额外注意事项 #

• 如果users表的外键列名不是email_id，请同步修改结构体标签和预加载中的Where条件。
• UserEmail仅作为数据传输/映射结构体，无需配置gorm关联标签，避免Gorm误判关联规则。

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