GORM复合主键详解（Go语言中如何正确设置和使用复合主键）

什么是复合主键？

复合主键是指由两个或多个字段共同组成的主键，用于唯一标识数据库表中的一条记录。例如，在订单明细表中，可能用 order_id 和 product_id 联合起来作为主键，确保同一个订单中不会重复添加同一商品。

GORM 中如何定义复合主键？

GORM 本身并不直接通过标签（tag）声明“这是复合主键”，而是通过不指定单一主键，并让多个字段参与唯一性约束来实现。关键在于：不要给任何一个字段打上 primaryKey 标签，而是依靠 GORM 的默认行为——当没有显式主键时，GORM 会尝试使用所有字段组成联合主键（但这不是推荐做法）。

更规范的做法是：使用 gorm:"primaryKey" 标签标记多个字段，GORM 会自动将它们组合成复合主键。

✅ 正确方式：为多个字段添加 primaryKey 标签

以下是一个典型的复合主键模型定义：

package mainimport (    "gorm.io/gorm"    "gorm.io/driver/sqlite" // 或 mysql、postgres 等)// OrderItem 表示订单中的商品项type OrderItem struct {    OrderID   uint `gorm:"primaryKey"`  // 复合主键的一部分    ProductID uint `gorm:"primaryKey"`  // 复合主键的另一部分    Quantity  int}func main() {    db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})    if err != nil {        panic("failed to connect database")    }    // 自动迁移模式，创建表    db.AutoMigrate(&OrderItem{})    // 插入数据    db.Create(&OrderItem{        OrderID:   1,        ProductID: 101,        Quantity:  2,    })    // 查询：必须同时提供两个主键字段    var item OrderItem    db.First(&item, "order_id = ? AND product_id = ?", 1, 101)    // 或者使用结构体查询    db.First(&item, OrderItem{OrderID: 1, ProductID: 101})}

在这个例子中，OrderID 和 ProductID 都被标记为 primaryKey，GORM 在建表时会自动将这两个字段设为复合主键。

注意事项与常见误区

• 不要遗漏任何主键字段：在执行查询、更新或删除操作时，必须提供完整的复合主键值，否则 GORM 可能无法准确定位记录。
• 避免使用自增 ID 与复合主键混用：如果你已经定义了复合主键，就不要再添加一个自增的 ID 字段并设为主键，这会导致逻辑混乱。
• 数据库兼容性：主流数据库（如 MySQL、PostgreSQL、SQLite）都支持复合主键，但某些 NoSQL 数据库可能不支持，请根据实际使用的数据库确认。

实战小结

通过以上示例，我们学会了在 Go语言GORM 中如何设置GORM复合主键。核心要点就是：为多个字段同时添加 gorm:"primaryKey" 标签。这种设计不仅符合数据库范式，还能有效防止数据重复。

希望这篇 GORM主键教程 能帮助你轻松掌握 Go复合主键设置 的技巧。如果你觉得有用，欢迎收藏并在项目中实践！

掌握 GORM 复合主键，让你的数据模型更严谨、更高效！