GORMDB迁移异步错误码断言 - 第1节

1.1 GORM 是什么

GORM 是 Go 语言生态中最流行的 全功能 ORM（Object Relational Mapping） 库，由开发者 Jinzhu 创建并持续维护。它通过将 Go 结构体与数据库表建立映射关系，让开发者能够以面向对象的方式操作数据库，而无需直接编写大量 SQL 语句。

截至当前版本，GORM 在 GitHub 上拥有超过 36k+ Star，被广泛应用于生产环境，是 Go 后端开发的事实标准 ORM 选型。

1.2 GORM 核心特性

GORM 提供了一组开箱即用的功能，覆盖了日常开发中 90% 以上的数据库操作场景。下表列出了其核心特性及简要说明：

1.3 GORM 与标准库 database/sql 的关系

理解 GORM 与 database/sql 的关系，是掌握 GORM 架构的关键。它们之间是 分层协作 的关系，而非替代关系。

• database/sql：Go 标准库提供的数据库抽象接口，定义了 DB、Tx、Stmt、Rows 等核心类型，以及连接池管理、事务生命周期等底层能力。它不关心具体数据库方言，通过注册驱动（如 mysql、postgres）实现多数据库支持。
• GORM：在 database/sql 之上构建的 ORM 层。它接收开发者传入的 *sql.DB 实例，封装了 SQL 生成、结果映射、关联处理、迁移等高级功能。GORM 内部最终仍调用 database/sql 的接口执行 SQL。

下图展示了 GORM 在 Go 数据库访问栈中的位置：

1.4 GORM 的 ORM 映射原理

ORM 的核心在于 对象与关系的双向映射。GORM 通过以下机制实现这一映射：

1.4.1 结构体 → 数据库表

GORM 遵循 约定优于配置 原则，默认将结构体名转换为蛇形复数形式作为表名，将字段名转换为蛇形小写作为列名。开发者也可以通过标签（Tag）显式覆盖默认行为。

// 定义模型
type User struct {
    ID        uint      `gorm:"primaryKey;autoIncrement"`
    Name      string    `gorm:"type:varchar(100);not null"`
    Email     string    `gorm:"uniqueIndex;size:255"`
    Age       int       `gorm:"default:18"`
    CreatedAt time.Time `gorm:"autoCreateTime"`
}

// 自动迁移：GORM 根据 User 结构体生成表
// CREATE TABLE `users` (
//   `id` bigint unsigned AUTO_INCREMENT PRIMARY KEY,
//   `name` varchar(100) NOT NULL,
//   `email` varchar(255) UNIQUE,
//   `age` bigint DEFAULT 18,
//   `created_at` datetime(3)
// );
db.AutoMigrate(&User{})

1.4.2 数据库行 → 结构体实例

当执行查询时，GORM 通过反射（reflect 包）解析目标结构体的字段类型和标签，将数据库返回的行数据逐列赋值给对应的字段。这一过程称为 扫描（Scan）。

var user User
// GORM 内部执行：SELECT * FROM users WHERE id = 1
// 然后将结果集的列名与 User 字段标签匹配，调用 reflect.Value.Set() 赋值
db.First(&user, 1)
// user.ID = 1, user.Name = "张三", user.Email = "zhangsan@example.com"

1.4.3 关联映射

GORM 支持四种关联关系，通过结构体嵌套和标签描述外键关系：

下图展示了 GORM 从结构体定义到数据库表生成的完整映射流程：