在gorm中嵌入多个同名字段结构体（如createdby/updatedby均含byid）会导致列名映射歧义，生成重复的by_id字段；正确做法是避免匿名嵌入，改用命名字段或直接复用基础结构体。
在gorm中嵌入多个同名字段结构体（如createdby/updatedby均含byid）会导致列名映射歧义，生成重复的by_id字段；正确做法是避免匿名嵌入，改用命名字段或直接复用基础结构体。
当使用GORM建模具有多组相似审计字段（如 created_by_id 和 updated_by_id）的表时，若采用匿名嵌入（embedding）方式定义结构体，极易引发字段名冲突与映射错误。根本原因在于：Go语言不允许对存在歧义的嵌入字段进行直接访问，而GORM在解析结构体标签和列映射时，会将所有嵌入层级中的同名字段（如 By.ByID）统一视为 by_id，从而丢失上下文前缀，最终导致迁移失败或数据写入错位。
✅ 正确实践：
禁用匿名嵌入，显式声明命名字段
推荐采用以下两种清晰、无歧义的结构设计：
方案一：复用基础结构体，作为命名字段（最简洁）
立即学习
“
go语言免费学习笔记（深入）
”；
✅ 关键点：embeddedPrefix 告诉GORM为该嵌入结构体的所有字段自动添加指定前缀（如 created_by_by_id → 实际映射为 created_by_id）。注意：需确保数据库列名与前缀拼接后一致（即列应为 created_by_id 而非 created_by_by_id），因此更推荐方案二。
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
方案二：完全扁平化，避免嵌入（最可靠，GORM v1.5+ 兼容性最佳）
✅ 优势：语义明确、无嵌入歧义、列名完全可控；配合 foreignKey 标签可正确建立关联，且无需额外逻辑即可支持预加载（Preload("CreatedBy")）。
⚠️ 注意事项：
GORM v1.5 不支持嵌入结构体的动态前缀重写（如 embeddedPrefix 在早期版本中行为不稳定），
强烈建议优先采用方案二
；
若坚持使用嵌入，请勿同时嵌入 CreatedBy 和 UpdatedBy（二者均含 By 字段），否则 Event.By 将无法编译；
所有外键字段（如 CreatedByID）必须与关联结构体的主键类型严格一致（此处为 sql.NullInt64 匹配 User.ID uint 时需注意类型兼容性，必要时改用 *uint 或自定义类型）；
迁移前务必执行 db.AutoMigrate(&Event{}) 并检查生成SQL，确认列名为 created_by_id 和 updated_by_id，而非 by_id。
总结：GORM 的嵌入机制服务于扁平化建模，而非面向对象继承。面对重复字段模式，应以“显式优于隐式”为原则——放弃嵌入语法糖，用命名字段换取确定性与可维护性。
type By struct {
ByID sql.NullInt64 `gorm:"column:by_id"`
By *User `gorm:"foreignKey:ByID"`
}
type Event struct {
gorm.Model
CreatedBy By `gorm:"embedded;embeddedPrefix:created_by_"`
UpdatedBy By `gorm:"embedded;embeddedPrefix:updated_by_"`
}type Event struct {
gorm.Model
CreatedByID sql.NullInt64 `gorm:"column:created_by_id"`
CreatedBy *User `gorm:"foreignKey:CreatedByID"`
UpdatedByID sql.NullInt64 `gorm:"column:updated_by_id"`
UpdatedBy *User `gorm:"foreignKey:UpdatedByID"`
}