AutoMigrate仅适合开发初期结构快速对齐，因其只安全补全（建表、加字段、扩类型、加索引/外键），不删字段、不改名、不降NOT NULL、不记录版本、不支持回滚，线上静默跳过变更易致schema与代码脱节。
AutoMigrate 适合什么场景，又为什么不能上生产
AutoMigrate 是 GORM 提供的“结构同步器”，只做安全补全：建表、加字段、扩类型（如 VARCHAR(100) → VARCHAR(255)）、加索引/外键。它不会删字段、不改字段名、不降级 NOT NULL、不重排列顺序、不记录版本、不支持回滚。
常见误用是把它塞进 e.Start() 前的启动流程里，以为“跑一次就稳了”。实际线上库早已有数据，AutoMigrate(&User{}) 静默跳过所有它认为无需操作的情况——哪怕你刚删了 Age 字段，DB 里字段还在，它也不吭声。
- 必须传结构体指针：
&User{}，传User{}会导致标签失效、主键识别失败 - 外键需显式配置：
CompanyID uint+Company Company `gorm:"foreignKey:CompanyID"`，否则约束不生成 - MySQL 默认禁用外键迁移，初始化 DB 时得设
DisableForeignKeyConstraintWhenMigrating: false - 多对多中间表（如
UserRole）GORM 绝不自动生成，必须单独定义 struct 并调AutoMigrate(&UserRole{})
gormigrate 怎么避免 invalid connection 和 panic
gormigrate.New 要求传入一个「已打开且未关闭」的 *gorm.DB。在 Echo 项目中，若把迁移逻辑放在路由注册之后、e.Start() 之前，但此时 db 还没完成连接池初始化或 AutoMigrate 调用，就会触发 invalid connection 或空指针 panic。
根本原因是 gormigrate 不管理连接生命周期，只依赖你给它的 db 实例状态可靠。
- 迁移必须紧邻
db初始化之后执行，比如db, _ := gorm.Open(...)后立刻调gormigrate.New(db, ...) - 绝对不要在
gormigrate.Migration函数里再调db.AutoMigrate()，二者语义冲突：一个是版本化变更，一个是强制覆盖同步 - 确保
gorm.Config中启用了PrepareStmt: true（尤其 MySQL 8.0+），否则带参数的ADD COLUMN IF NOT EXISTS类语句会预处理失败 - 本地 SQLite 成功、上线 PostgreSQL 报
syntax error at or near "IF"？那是你写了原生 SQL —— 改用db.Migrator().AddColumn()
手动迁移该用 Migrator 还是写原生 SQL
优先走 db.Migrator() 链式调用，不是为了“高级”，而是为了跨方言兼容性。gormigrate.Migrate() 只负责按序执行函数，不解析 SQL 语法；你写的 ALTER TABLE users ADD COLUMN IF NOT EXISTS status TEXT 在 SQLite 能跑，到 PostgreSQL 就卡住。
真正需要手写 SQL 的情况极少，且必须显式判断驱动：
- 新增/删除列：统一用
db.Migrator().AddColumn()/.DropColumn() - 建/删索引：用
CreateIndex()/DropIndex()，别写CREATE INDEX CONCURRENTLY（仅 PostgreSQL 支持） - 真要执行方言特有语句：先判断
if db.Dialector.Name() == "postgres"，再写对应 SQL - MySQL 上
RENAME COLUMN在某些版本不稳定，初始化 DB 时可加DontSupportRenameColumn: true，让它退化为CHANGE COLUMN
Go 程序内调 migrate.Up() 如何防 panic
直接在 main() 里调 m.Up() 很常见，但连接失败、SQL 语法错、MySQL 锁表超时都会导致 panic，生产环境不能接受。
必须包裹 context 超时控制，并区分错误类型：
- 用
context.WithTimeout(ctx, 30*time.Second)包裹，防止 DDL 卡死无响应 - 检查
err == migrate.ErrNoChange（无新迁移）和err == migrate.ErrLocked（被其他实例抢占锁），别一概log.Fatal -
migrate.New的数据库 URL 必须从环境变量读，如os.Getenv("DB_URL")，禁止硬编码 - 已有线上库必须先
migrate status查当前版本，再migrate force 1标记历史状态，否则直接up会报重复建表错
最易被忽略的是：AutoMigrate 永远静默，它不告诉你“这次什么都没干”。上线前务必用 db.Migrator().HasTable(&User{}) 和 .HasColumn(&User{}, "email") 主动验证关键结构是否就位。
