AutoMigrate是结构同步器，能建表、加字段、改类型、加索引/外键，但不删字段/表、不改字段名、不降级NOT NULL；需正确传指针、配标签、处理外键与中间表，慎用于生产。
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 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
立即学习“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，可能因并发建表/加索引冲突，建议只由一个实例（如主节点）执行
