Golang GORM怎么做自动迁移建表_Golang GORM迁移教程【精通】-Golang-PHP中文网

automigrate是结构同步器，能建表、加字段、改类型、加索引/外键，但不删字段/表、不改字段名、不降级not null；需正确传指针、配标签、处理外键与中间表，慎用于生产。

golang gorm怎么做自动迁移建表_golang gorm迁移教程【精通】

AutoMigrate 能干啥、不能干啥，得先拎清

它不是“数据库版本管理工具”，也不是“一键回滚迁移器”——AutoMigrate本质是**结构同步器**：对比当前 Go 结构体和数据库表的差异，做最小化补全。能建表、加字段、改字段类型（如 string 从 size:20 改成 size:100）、加索引/外键；但不会删字段、不会删表、不会改字段名（除非你用 Migrator.RenameColumn 显式调）、也不会把 NOT NULL 字段改成可空（除非你显式加 gorm:"null" 标签并触发类型变更）。

常见错误现象：
• 加了新字段却没进数据库 → 忘了跑 AutoMigrate 或没传对指针（比如传 User{} 而非 &User{}）
• 字段类型没更新 → 比如把 Age int 改成 Age int64，但 MySQL 原列是 INT，GORM 默认不升级类型（需配合 gorm:"type:bigint" 或启用 DisableForeignKeyConstraintWhenMigrating 等配置影响行为）
• 外键没生成 → 初始化 DB 时没关掉 DisableForeignKeyConstraintWhenMigrating: true（默认是 true）

怎么写结构体才能让 AutoMigrate 生效又安全

结构体不是随便定义完就能迁的，字段标签直接决定 SQL 行为。尤其要注意三类易错点：

ID uint 不等于主键 —— 必须显式加 gorm:"primaryKey"，否则 GORM 可能忽略或报错
外键字段要配对声明：比如 UserID uint 是外键，就得在关联 struct 里写 User gorm.Model 或加 gorm:"foreignKey:UserID"，否则 AutoMigrate 不知道该建哪个约束
多对多必须手动建中间表 struct：GORM 不会自动生成 user_roles 这类 join 表，你得自己定义 type UserRole struct { UserID uint; RoleID uint }，再单独 AutoMigrate(&UserRole{})

示例：

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

type User struct {
  ID        uint      `gorm:"primaryKey"`
  Name      string    `gorm:"size:50;not null"`
  Email     string    `gorm:"uniqueIndex"`
}

type Order struct {
  ID       uint `gorm:"primaryKey"`
  UserID   uint `gorm:"index"` // 仅加索引
  User     User `gorm:"foreignKey:UserID"` // 显式声明外键关系
}

批量迁移、带选项建表、跨数据库兼容性要点

一次迁多个模型很常见，但顺序和配置会影响结果：

批量调用更高效：db.AutoMigrate(&User{}, &Product{}, &Order{}) 比三次单个调用快，且能自动处理外键依赖顺序
想指定引擎或字符集？用 db.Set("gorm:table_options", "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4") 再调 AutoMigrate，否则 MySQL 默认可能用 MyISAM 或 latin1
SQLite 不支持 ALTER COLUMN，GORM 会“重建表”：创建新表 → 复制数据 → 删旧表 → 重命名。这意味着如果表很大，AutoMigrate 可能卡住或失败，生产环境慎用
MySQL 5.7 之前不支持 RENAME COLUMN，得设 DontSupportRenameColumn: true，否则迁移报错

开发阶段够用，但别往生产环境硬套

AutoMigrate 的设计目标就是“开发快速对齐”，不是“生产灰度发布”。它没有回滚能力、不记录变更历史、不校验数据一致性。上线前如果涉及字段删除、类型收缩（如 VARCHAR(200) → VARCHAR(50)）、或大表加索引，必须人工介入。

容易被忽略的地方：
• AutoMigrate 不会校验字段值是否合法（比如给已存 NOT NULL 字段加 gorm:"null"，已有空值数据不会被清理）
• 它不感知数据库权限 —— 如果 DB 用户没 ALTER 权限，迁移会静默失败或报错 ERROR 1142 (42000): ALTER command denied
• 多实例服务同时启动并执行 AutoMigrate，可能因并发建表/加索引冲突，建议只由一个实例（如主节点）执行

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！