GORM 中嵌入 gorm.Model 后不可再手动声明同名字段（如 ID、CreatedAt），否则会导致数据库建表失败；Go 的结构体嵌入是“组合”而非“继承”，被嵌入类型字段会直接展开到外层结构体中，造成重复定义。
gorm 中嵌入 `gorm.model` 后不可再手动声明同名字段（如 `id`、`createdat`），否则会导致数据库建表失败；go 的结构体嵌入是“组合”而非“继承”，被嵌入类型字段会直接展开到外层结构体中，造成重复定义。
在使用 GORM 定义数据模型时，一个常见误区是试图同时嵌入 gorm.Model 并手动重复声明其内置字段，例如：
type User struct {
gorm.Model // ← 自动包含 ID, CreatedAt, UpdatedAt, DeletedAt
ID uint // ❌ 错误：ID 已由 gorm.Model 提供
CreatedAt time.Time // ❌ 错误：CreatedAt 已存在
Name string
}
这段代码在调用 db.AutoMigrate(&User{}) 或 db.CreateTable(&User{}) 时，PostgreSQL 会报错：
pq: column "id" specified more than once pq: column "created_at" specified more than once
原因在于：Go 语言中结构体嵌入（embedding）不是面向对象的“继承”，而是字段的自动展开（field promotion）。gorm.Model 中已定义 ID uint 和 CreatedAt time.Time，当它被嵌入 User 时，这两个字段就等价于直接写在 User 结构体内部；此时若再显式声明同名字段，Go 编译器虽允许（因字段作用域不同，可共存），但 GORM 在生成 SQL 表结构时会将二者都视为需映射的数据库列，最终导致 DDL 语句中出现重复列名。
✅ 正确做法是「二选一」：
-
方式一（推荐）：仅嵌入
gorm.Model，按需覆盖标签type User struct { gorm.Model // 提供 ID, CreatedAt, UpdatedAt, DeletedAt Name string Email string `gorm:"uniqueIndex"` // 如需自定义字段行为，用 struct tag 控制，而非重定义字段 }✅ 简洁、安全、符合 GORM 设计哲学；所有时间字段自动受 GORM 生命周期管理（如
CreatedAt插入时自动赋值，UpdatedAt更新时自动更新）。 -
方式二：完全自定义字段，不嵌入
gorm.Modeltype User struct { ID uint `gorm:"primaryKey"` CreatedAt time.Time `gorm:"autoCreateTime"` UpdatedAt time.Time `gorm:"autoUpdateTime"` DeletedAt *time.Time `gorm:"index"` Name string Email string }✅ 灵活性更高，适合需要精细控制时间字段行为或兼容非标准主键策略的场景；但需手动声明全部基础字段及其 GORM 标签。
⚠️ 特别注意：
gorm.Model是 GORM 提供的约定式基础模型，不是接口或抽象类，它的字段不具备“虚函数”语义；Go 不支持传统继承，
type User struct { gorm.Model; ... }本质是语法糖，等价于把gorm.Model的所有字段平铺复制进User；-
若需“读写分离”（如创建时不传
ID、查询时需返回ID），不应通过定义两个结构体解决，而应利用 GORM 的字段权限标签（如、<code>->、-）实现单结构体的细粒度控制：type User struct { ID uint `gorm:"primaryKey;autoIncrement"` // 创建/查询均可见 Name string Password string `gorm:""` // 仅读取（如后台计算状态，不入库） Internal string `gorm:"-"` // 完全忽略（运行时内存字段） }
? 总结：GORM 模型设计应遵循 “一个结构体 + 标签驱动行为” 原则。避免字段重复是 Go 结构体嵌入机制的自然约束，而非框架缺陷；合理运用 gorm.Model 和 struct tags，即可在单个类型中安全、高效地支撑完整 CRUD 场景，无需拆分为 CreateUser / RetrieveUser 等冗余类型。
