1. GORM 迁移概述
1.1 什么是数据库迁移
数据库迁移（Database Migration）是指对数据库结构进行版本化、可追溯的变更管理过程。它不同于数据迁移（数据导入/导出），核心关注点是表结构、索引、约束、外键等 Schema 对象的创建、修改与删除。
在 Go 语言生态中，GORM 提供了内置的迁移能力，允许开发者通过 Go 结构体直接驱动数据库表结构的变更，无需手写 DDL 语句。
| 对比维度 | 传统 DDL 脚本 | GORM 迁移 |
|---|---|---|
| 定义方式 | 手写 SQL（CREATE/ALTER/DROP） | Go 结构体 Tag + 自动推断 |
| 版本管理 | 需外部工具（Flyway/Liquibase） | 内置 AutoMigrate，无版本号 |
| 跨数据库兼容 | 需为每种数据库写不同 SQL | GORM 自动适配 MySQL/PostgreSQL/SQLite 等 |
| 回滚能力 | 需手动编写回滚脚本 | AutoMigrate 不支持自动回滚 |
核心要点：数据库迁移解决的是“代码版本”与“数据库结构版本”之间的同步问题。没有迁移机制，团队协作时极易出现“在我本地能跑”的尴尬局面。
1.2 GORM AutoMigrate 简介
GORM 的 AutoMigrate 是框架内置的自动迁移方法，它会根据传入的模型结构体自动创建表、添加字段、修改字段类型或增加索引。调用方式极为简洁：
import (
"gorm.io/gorm"
"gorm.io/driver/sqlite"
)
type User struct {
ID uint `gorm:"primaryKey"`
Name string `gorm:"size:100;not null"`
Age int `gorm:"default:18"`
}
func main() {
db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
// 自动迁移 —— 一行代码完成表结构同步
db.AutoMigrate(&User{})
}AutoMigrate 的行为规则如下：
- 新增表：如果表不存在，根据结构体创建新表。
- 新增字段：如果表存在但缺少字段，添加新列。
- 修改字段：如果字段存在但类型/约束变化，尝试修改（受数据库限制）。
- 删除索引：如果结构体中去掉了索引 Tag，自动删除对应索引。
- 不会删除列：即使结构体删除了字段，表中对应列也不会被删除——这是安全设计。
最佳实践：开发环境使用 AutoMigrate 快速迭代；生产环境建议使用版本化迁移工具（如 golang-migrate）或手动编写 DDL 脚本，避免自动修改带来的风险。
1.3 迁移在项目中的重要性
数据库迁移不是“锦上添花”的功能，而是中大型项目的基础设施。缺少迁移机制的项目，通常会遇到以下问题：
- 环境不一致：开发、测试、预发布、生产四个环境的表结构无法保证一致。
- 协作冲突：多人同时修改模型，合并代码后表结构冲突难以排查。
- 回滚困难：上线后发现字段类型错误，没有回滚脚本只能手动修复。
- 审计缺失：无法追溯“谁在什么时间改了哪个字段”。
- 冒烟测试盲区：CI/CD 流水线中缺少对数据库结构变更的验证环节。
| 项目阶段 | 无迁移机制 | 有迁移机制 |
|---|---|---|
| 开发阶段 | 手动建表，频繁删表重建 | AutoMigrate 自动同步，秒级完成 |
| 代码评审 | 无法审查表结构变更 | 通过模型 diff 即可审查 |
| CI/CD 流水线 | 无法自动验证数据库变更 | 冒烟回归自动检查迁移结果 |
| 生产上线 | 手动执行 DDL，风险高 | 版本化迁移，可回滚可追溯 |
| 故障恢复 | 需从备份重建表结构 | 迁移脚本重放即可恢复 |
冒烟回归视角：本课程的核心目标之一，就是教会你如何在 CI/CD 流水线中嵌入 GORM 迁移的冒烟测试——每次代码提交后自动执行迁移、验证表结构正确性、捕获字段类型不匹配或索引缺失等回归缺陷。迁移不是一次性的操作，而是需要持续验证的流程。
1.4 本章小结
- 数据库迁移是管理表结构版本化的核心手段，GORM 的
AutoMigrate提供了开箱即用的自动迁移能力。 - AutoMigrate 能自动创建表、添加字段、修改类型和索引，但不会删除列或表，这是安全设计。
- 迁移在项目中的重要性体现在：环境一致性、协作效率、回滚能力、审计追踪和冒烟回归验证。
- 本课程后续章节将深入讲解 AutoMigrate 的边界行为、高级配置、自定义迁移以及如何在 CI/CD 中构建冒烟回归测试用例。