GORM Postgres迁移报错违反pg_type_typname_nsp_index唯一约束如何解决

你遇到的duplicate key value violates unique constraint "pg_type_typname_nsp_index"报错是PostgreSQL系统表的唯一约束冲突，本质是GORM在迁移过程中重复尝试创建同名的数据库类型/关联对象，结合你提供的模型代码和驱动版本，具体原因如下：

• 双向多对多关系重复配置冲突：你在Group和User模型中都声明了指向user_groups中间表的多对多关联，且两侧都配置了相同的级联约束规则。你使用的gorm.io/driver/postgres@v1.1.0版本存在已知bug，处理这种双向多对多配置时，会重复执行中间表关联的类型创建逻辑，触发PostgreSQL系统表的唯一约束冲突。
• 迁移逻辑不规范：如果调用db.AutoMigrate()时重复传入相同模型，或者传入模型的顺序不符合依赖关系，也可能导致GORM循环处理关联对象，重复触发创建逻辑。
• 环境残留对象：如果之前执行过失败的迁移，可能残留未清理干净的同名类型、中间表碎片，也会触发该冲突。

按优先级执行以下操作即可解决问题：

1. 简化多对多关系配置：仅在多对多关系的一侧保留完整约束配置，另一侧只声明关联的中间表即可，比如修改User模型的Groups字段标签：

// 原配置：gorm:"many2many:user_groups;constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"
// 修改后：
Groups    []Group    `gorm:"many2many:user_groups;"`

2. 升级GORM相关依赖到最新稳定版，该bug在后续驱动版本中已经被修复，执行以下命令升级：

go get gorm.io/gorm@latest
go get gorm.io/driver/postgres@latest

3. 调整迁移调用逻辑，单次调用AutoMigrate时按依赖顺序传入所有模型，不要重复传入相同模型，参考顺序：

err := db.AutoMigrate(
    &SopsPair{},
    &ClusterConfiguration{},
    &Group{},
    &StackRequiredParameter{},
    &StackOptionalParameter{},
    &Stack{},
    &InstanceRequiredParameter{},
    &InstanceOptionalParameter{},
    &Instance{},
    &User{},
)

4. 开发/测试环境可以先清空当前schema下的所有表和自定义类型，再重新执行迁移，排除残留对象干扰。

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