GORM外键未生成对应字段问题及UUID主键配置咨询

一、核心问题梳理 #

你当前存在两个关键问题：

1. 自定义UUID主键时和gorm.Model自带的uint类型ID冲突，导致主键配置未按预期生效
2. 关联关系逻辑搞反，不符合「每个饮品对应一个门店」的业务需求，因此外键字段未正确生成

二、正确替换GORM默认uint主键为UUID #

gorm.Model自带的ID是uint类型，直接在结构体中重复定义ID uuid.UUID会造成字段冲突，GORM无法正确识别。提供两种解决方法：

方法1：自定义带UUID的基础模型 #

自己实现包含UUID主键、时间字段和软删除字段的基础结构体，替换默认的gorm.Model：

import (
  "github.com/google/uuid"
  "gorm.io/gorm"
  "time"
)

// UUIDModel 自定义基础模型，替代gorm.Model
type UUIDModel struct {
  ID        uuid.UUID `gorm:"type:uuid;primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
}

之后在业务模型中嵌入这个自定义模型：

type Drink struct {
  UUIDModel
  // 其他业务字段
}

type Location struct {
  UUIDModel
  // 其他业务字段
}

方法2：手动声明所有字段 #

如果不想自定义基础模型，直接去掉gorm.Model，手动添加所需字段：

type Drink struct {
  ID        uuid.UUID `gorm:"type:uuid;primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
  // 其他业务字段
}

必做配置：无论用哪种方法，都要设置UUID的默认生成规则，建议在数据库连接完成后添加：

// 全局注册UUID生成器，创建记录时自动生成UUID主键
db.Callback().Create().Before("gorm:create").Register("uuid_generator", func(db *gorm.DB) {
  if db.Statement.Schema.PrimaryField != nil {
    if db.Statement.Schema.PrimaryField.Field.Type().String() == "uuid.UUID" {
      id := uuid.New()
      db.Statement.SetColumn(db.Statement.Schema.PrimaryField.Name, id)
    }
  }
})

三、修复关联关系，生成正确外键 #

你的业务需求是「每个饮品对应一个门店，不同门店的同款饮品分开存储」，这属于多对一关联（多个饮品对应一个门店），外键应该放在drinks表中（字段名location_id），而非反向存储。

修正后的完整模型代码 #

type Drink struct {
  UUIDModel
  Name        string    `gorm:"index;not null"`
  Volume      float64   `gorm:"not null;type:decimal(10,2)"`
  ABV         float64   `gorm:"not null;type:decimal(10,2)"`
  Price       float64   `gorm:"not null;type:decimal(10,2)"`
  // 外键字段，关联Location表的ID主键
  LocationID  uuid.UUID
  // 关联模型，GORM自动识别LocationID对应Location的ID
  Location    Location  `gorm:"constraint:OnDelete:CASCADE;"`
}

type Location struct {
  UUIDModel
  Name     string `gorm:"not null"`
  Address  string `gorm:"not null"` // 修正：地址是字符串，不能用decimal类型
  Phone    string `gorm:"not null;type:varchar(20)"` // 修正：手机号用string避免int溢出
  // 可选反向关联：查看某门店下的所有饮品
  Drinks   []Drink `gorm:"foreignKey:LocationID"`
}

关键修正说明 #

1. 关联逻辑反转：将外键从Location的DrinkID移到Drink的LocationID，匹配「饮品属于门店」的业务逻辑
2. 字段类型修正：Location的Address之前错误使用decimal(10,2)，改为字符串类型；Phone用string替代int，避免大号码溢出问题
3. 约束添加：给关联模型加constraint:OnDelete:CASCADE，保证删除门店时自动删除关联饮品（可根据业务需求调整为SET NULL等）

四、执行迁移验证 #

修正模型后，重新执行GORM迁移：

err := db.AutoMigrate(&Drink{}, &Location{})
if err != nil {
  // 处理迁移错误
}

此时drinks表会生成location_id外键字段，关联locations表的id，完全满足你的业务需求。

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