Gorm AutoMigrate报错：表已存在却仍尝试创建表

我在GCP的Go应用中使用Gorm连接Postgres Cloud SQL数据库，以下是数据库连接与迁移代码。该代码（除模型不同外）在另一个Go应用中可正常运行，但运行当前服务时，日志显示执行AutoMigrate时出现“pq: relation 'users' already exists”错误，服务随即终止。我使用Cloud Code本地运行环境，模型均包含gorm.Model，不清楚问题所在。

连接代码 #

func CreateDBConnection(cfg *config.Config) (*gorm.DB, error) {
    // Build the connection string
    dsn := fmt.Sprintf("host=%s user=%s dbname=%s password=%s sslmode=disable",
        cfg.DatabaseHost, cfg.DatabaseUser, cfg.DatabaseName, cfg.DatabasePassword)
    // Open a database connection
    db, err := gorm.Open(postgres.New(postgres.Config{
        DriverName: "cloudsqlpostgres",
        DSN:        dsn,
    }))
    if err != nil {
        log.Fatal(err)
        return nil, err
    }

    // Migrate the schema
    err = db.AutoMigrate(&model.User{})
    if err != nil {
        log.Fatal(err)
        return nil, err
    }

    err = db.AutoMigrate(&model.ExerciseEvent{})
    if err != nil {
        log.Fatal(err)
        return nil, err
    }

    err = db.AutoMigrate(&model.HeartRecord{})
    if err != nil {
        log.Fatal(err)
        return nil, err
    }

    return db, nil
}

日志信息 #

[user-service-74b59f7fff-zdsfx user-service-container] 2023/08/09 15:13:46 refreshing ephemeral certificate for instance mynormative-grpc-dev:northamerica-northeast2:user-service-dev
[user-service-74b59f7fff-zdsfx user-service-container] 2023/08/09 15:13:47 Generated RSA key in 193.751709ms
[user-service-74b59f7fff-zdsfx user-service-container] 2023/08/09 15:13:47 Scheduling refresh of ephemeral certificate in 55m0s
[user-service-74b59f7fff-zdsfx user-service-container] 2023/08/09 15:13:47 pq: relation "users" already exists
[user-service-74b59f7fff-zdsfx user-service-container]
[user-service-74b59f7fff-zdsfx user-service-container] 2023/08/09 15:13:47 /user-service/internal/repository/cloud_storage.go:28 pq: relation "users" already exists
[user-service-74b59f7fff-zdsfx user-service-container] [15.230ms] [rows:0] CREATE TABLE "users" [COLUMNS.....]

User模型 #

type User struct {
    gorm.Model
    Id              string
    Name            string
    Email           string
    Sex             string
    BirthDate       Timestamp
    Country         string
    EthnicitiesList pq.StringArray `gorm:"type:text[]"`
    Lifestage       string
    IsMenstruating  bool
    CycleDuration   int64
    IsCycleVariable bool
    PeriodDuration  int64
    LastPeriodDate  Timestamp
} 

问题原因与解决办法 #

1. 模型与现有表结构不匹配（核心原因） #

你的User模型同时包含gorm.Model和自定义的Id string字段，而gorm.Model自带了ID uint作为默认主键。这会导致Gorm生成的表结构与数据库中已存在的users表结构不一致，Gorm无法识别现有表，从而尝试重复创建。

解决方式：

• 移除自定义的Id string字段，直接使用gorm.Model提供的ID uint作为主键，确保模型与现有表的主键类型一致。
• 如果必须使用字符串类型主键，给自定义Id字段添加gorm:"primaryKey"标签，同时确保数据库中users表的主键为字符串类型：

  type User struct {
      gorm.Model
      Id              string `gorm:"primaryKey"` // 显式指定为主键
      // 其他字段...
  }
  

2. 驱动兼容性问题 #

你使用的cloudsqlpostgres驱动可能与标准Postgres驱动存在差异，导致Gorm的表存在性检测逻辑失效。

解决方式：
改用标准Postgres驱动，修改连接代码中的DriverName为"postgres"：

db, err := gorm.Open(postgres.New(postgres.Config{
    DriverName: "postgres", // 替换为标准驱动
    DSN:        dsn,
}))

3. 优化AutoMigrate调用方式 #

将多个模型的AutoMigrate调用合并为一次，减少重复操作并避免潜在的执行顺序问题：

// 合并所有模型的迁移操作
err = db.AutoMigrate(&model.User{}, &model.ExerciseEvent{}, &model.HeartRecord{})
if err != nil {
    log.Fatal(err)
    return nil, err
}

4. 手动验证表结构匹配度 #

• 直接连接Postgres Cloud SQL数据库，查看users表的实际结构，对比User模型的字段类型、主键定义是否完全一致。
• 测试环境下可先删除users表，重新执行迁移，验证模型是否能正确生成表结构。

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