调用Gorm AutoMigrate报唯一约束匹配错误，如何修复？

问题背景 #

定义了以下Gorm结构体，期望建立数据中心包含多个集群、集群包含多个服务器的关联关系：

结构体代码 #

type datacenter struct {
    Name          string    `gorm:"unique" json:"name"`
    Datacenter_Id uuid.UUID `gorm:"type:uuid;primaryKey" json:"datacenter_id"`
    Cluster_List []Cluster  `gorm:"foreignKey:Datacenter_Id" json:"clusters"`
    CreatedAt    time.Time
    UpdatedAt    time.Time
    DeletedAt    gorm.DeletedAt `gorm:"index"`
}

type Cluster struct {
    Cluster_Id      uuid.UUID      `gorm:"type:uuid;primary_key;unique" json:"id"`
    Num             int            `gorm:"unique" json:"num"`
    Datacenter_Id   uuid.UUID      `json:"Datacenter_id"`                        
    Servers_List    []Server       `gorm:"foreignKey:Cluster_Id" json:"servers"`
    CreatedAt       time.Time      `json:"createdAt"`
    UpdatedAt       time.Time      `json:"updatedAt"`
    DeletedAt       gorm.DeletedAt `gorm:"index"`
}

type Server struct {
    Scale_unit    int       `gorm:"unique" json:"scale_unit"`
    Server_Id     uuid.UUID `gorm:"type:uuid;primaryKey" json:"server_id"`
    IP_Address    string    `json:"ip_address"`
    Cluster_Id    uuid.UUID `json:"cluster_id"`
    CreatedAt     time.Time
    UpdatedAt     time.Time
    DeletedAt     gorm.DeletedAt `gorm:"index"`
}

自动迁移代码 #

if err := My_DB.AutoMigrate(&models.Datacenter{}); err != nil {
    log.Fatalf("Error auto-migrating: %v", err)
}

if err := My_DB.AutoMigrate(&models.Cluster{}); err != nil {
    log.Fatalf("Error auto-migrating: %v", err)
}

if err := My_DB.AutoMigrate(&models.Server{}); err != nil {
    log.Fatalf("Error auto-migrating: %v", err)
}

报错信息 #

2023/12/21 22:50:49 /app/database/db.go:116 ERROR: there is no unique constraint matching given keys for referenced table "datacenters" (SQLSTATE 42830)
[13.584ms] [rows:0] CREATE TABLE "clusters" ("cluster_id" uuid UNIQUE,"num" bigint UNIQUE,"datacenter_id" uuid,"created_at" timestamptz,"updated_at" timestamptz,"deleted_at" timestamptz,PRIMARY KEY ("cluster_id"),CONSTRAINT "fk_datacenters_clusters_list" FOREIGN KEY ("datacenter_id") REFERENCES "datacenters"("datacenter_id"))
2023/12/21 22:50:49 Error auto-migrating: ERROR: there is no unique constraint matching given keys for referenced table "datacenters" (SQLSTATE 42830)

尝试给datacenter_id添加unique约束后问题依旧，求修复方案。

解决方案 #

1. 修正结构体字段的关联标签 #

PostgreSQL对标识符大小写敏感（默认转小写），且Gorm的外键关联需要明确指定引用字段。修改Cluster结构体的Datacenter_Id字段标签，明确关联主表的主键：

type Cluster struct {
    // 其他字段保持不变
    Datacenter_Id   uuid.UUID      `gorm:"column:datacenter_id;references:datacenter_id" json:"datacenter_id"`                        
    // 其他字段保持不变
}

同时确保datacenter结构体的主键标签清晰：

type datacenter struct {
    // 其他字段保持不变
    Datacenter_Id uuid.UUID `gorm:"type:uuid;primaryKey;column:datacenter_id" json:"datacenter_id"`
    // 其他字段保持不变
}

2. 调整自动迁移的执行方式 #

Gorm支持一次性传入多个结构体，它会自动处理关联表的创建顺序，避免手动拆分迁移导致的依赖问题：

if err := My_DB.AutoMigrate(&models.Datacenter{}, &models.Cluster{}, &models.Server{}); err != nil {
    log.Fatalf("Error auto-migrating: %v", err)
}

3. 清理残留的旧表结构（测试环境） #

如果之前的迁移操作在数据库中留下了不完整的表或约束，可能导致新迁移失败。测试环境下可以先删除datacenters、clusters、servers表，再重新执行迁移。

4. 强制指定表名避免大小写问题 #

如果Gorm生成的表名与数据库中实际表名大小写不一致，会导致外键引用失败。可以通过结构体方法强制指定表名：

type datacenter struct {
    // 字段定义不变
}

func (datacenter) TableName() string {
    return "datacenters"
}

type Cluster struct {
    // 字段定义不变
}

func (Cluster) TableName() string {
    return "clusters"
}

type Server struct {
    // 字段定义不变
}

func (Server) TableName() string {
    return "servers"
}

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