Golang Gorm 2带外键关联表自动迁移报唯一约束不存在问题咨询

• 主键定义冲突：gorm.Model默认自带ID字段作为主键，你额外声明的ObjectId虽然加了主键标签，但未覆盖默认主键，导致Object表实际生成复合主键，外键引用单个ObjectId字段时找不到对应的唯一约束，触发报错。
• Gorm标签拼写错误：Gorm 2的主键标签为驼峰格式primaryKey，你使用的旧版本格式primary_key不生效，ObjectId未被正确设置为唯一主键。
• 迁移执行顺序错误：你先执行约束创建逻辑，再执行建表迁移，表结构未生成时约束创建逻辑异常，也会导致报错。

1. 修正模型定义 #

两种可选方案，根据你的业务需求选择：

方案A：覆盖gorm.Model默认主键 #

import "gorm.io/gorm"

type Object struct {
    gorm.Model `gorm:"embedded"`
    ID         uint   `gorm:"-"` // 忽略gorm.Model自带的默认ID主键
    ObjectId   string `gorm:"primaryKey;unique"` // 正确的Gorm 2主键标签
    ListItems  []ListItem `gorm:"foreignKey:ObjectId;references:ObjectId"`
}

type ListItem struct {
    gorm.Model
    ObjectId string
    Data     string
}

方案B：移除gorm.Model自定义全字段 #

如果不需要软删等gorm.Model自带能力，可以直接自定义字段避免主键冲突：

import (
    "gorm.io/gorm"
    "time"
)

type Object struct {
    ID         uint      `gorm:"primaryKey;autoIncrement"`
    CreatedAt  time.Time
    UpdatedAt  time.Time
    DeletedAt  gorm.DeletedAt `gorm:"index"`
    ObjectId   string         `gorm:"primaryKey;unique"`
    ListItems  []ListItem     `gorm:"foreignKey:ObjectId;references:ObjectId"`
}

type ListItem struct {
    ID         uint      `gorm:"primaryKey;autoIncrement"`
    CreatedAt  time.Time
    UpdatedAt  time.Time
    DeletedAt  gorm.DeletedAt `gorm:"index"`
    ObjectId   string
    Data       string
}

2. 修正迁移代码 #

调整执行顺序，先建表再处理约束，模型定义正确的前提下AutoMigrate会自动生成外键，不需要手动调用约束创建接口：

// 优先执行迁移建表
err := db.AutoMigrate(&Object{}, &ListItem{})
if err != nil {
    // 处理迁移错误
}

// 仅当需要手动重建约束时，再执行下方代码
// err = db.Migrator().CreateConstraint(&Object{}, "ListItems")
// if err != nil {
//     // 处理约束创建错误
// }

如果你的业务不需要数据库层面的物理外键约束，可以在初始化Gorm实例时添加配置，避免这类外键相关的迁移问题：

db, err := gorm.Open(postgres.Open("你的DSN"), &gorm.Config{
    DisableForeignKeyConstraintWhenMigrating: true, // 关闭自动创建物理外键
})

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