GORM AutoMigrate尝试删除不存在索引的问题排查与解决

• GORM对普通索引和唯一索引有不同的默认命名规则：普通索引为idx_表名_字段名，唯一索引为uni_表名_字段名。
• 当你给CorpId添加uniqueIndex标签后，AutoMigrate会先尝试删除该字段对应的旧唯一约束（按规则应为uni_customer_corpid），再创建新的唯一索引。但实际上数据库中仅存在之前生成的普通索引idx_customer_corpid，不存在预期的uni_customer_corpid约束，因此触发报错。

办法1：手动删除旧索引后重新执行AutoMigrate #

直接在数据库中执行SQL删除普通索引：

DROP INDEX idx_customer_corpid;

执行完成后重新运行AutoMigrate代码，GORM会自动创建符合要求的唯一索引uni_customer_corpid。

办法2：使用GORM Migrator接口手动处理索引 #

通过GORM的Migrator工具先删除旧的普通索引，再创建新的唯一索引，代码示例：

migrator := dbInstance.Migrator()

// 检查并删除旧的普通索引
if migrator.HasIndex(&models.Customer{}, "idx_customer_corpid") {
    if err := migrator.DropIndex(&models.Customer{}, "idx_customer_corpid"); err != nil {
        // 此处处理错误
    }
}

// 检查并创建新的唯一索引
if !migrator.HasIndex(&models.Customer{}, "uni_customer_corpid") {
    if err := migrator.CreateIndex(&models.Customer{}, "CorpId"); err != nil {
        // 此处处理错误
    }
}

GORM会根据结构体中的uniqueIndex标签，自动将CorpId的索引创建为唯一索引。

办法3：直接执行SQL创建唯一索引 #

若不想依赖GORM的自动逻辑，可直接执行SQL创建唯一索引（注意GORM默认将表名转为复数，即customers）：

CREATE UNIQUE INDEX uni_customer_corpid ON customers(corpid);

创建完成后，后续执行AutoMigrate时不会再报错，因为GORM会检测到唯一索引已存在。

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