1. GORM 基础回顾：核心概念、模型定义、自动迁移与 CRUD 基本操作

GORM 是 Go 语言生态中最流行的 ORM 框架，在微服务架构中承担着数据持久化的核心职责。本章从零梳理 GORM 的基础骨架，为后续并发瓶颈分析与慢查询复盘打下坚实根基。

1.1 核心概念速览

1.2 模型定义与标签体系

GORM 通过结构体标签（Tag）控制字段映射、约束与行为。以下是一个典型的订单模型：

type Order struct {
    ID        uint      `gorm:"primaryKey;autoIncrement"`
    OrderNo   string    `gorm:"type:varchar(32);uniqueIndex;not null"`
    UserID    uint      `gorm:"index;not null"`
    Amount    float64   `gorm:"type:decimal(12,2);default:0"`
    Status    int8      `gorm:"default:0"`
    CreatedAt time.Time `gorm:"autoCreateTime"`
    UpdatedAt time.Time `gorm:"autoUpdateTime"`
    DeletedAt gorm.DeletedAt `gorm:"index"` // 软删除
}

1.3 自动迁移机制

db.AutoMigrate(&Order{}, &User{}) 会根据模型自动创建表、添加列和索引。其行为规则如下：

• 表不存在 → 创建表
• 表存在，缺少列 → 新增列
• 表存在，列类型不匹配 → 不修改（仅日志警告）
• 表存在，多余列 → 不删除
• 索引缺失 → 创建索引

// 初始化 DB 并自动迁移
dsn := "host=localhost user=gorm password=secret dbname=orders port=5432 sslmode=disable"
db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{
    Logger: logger.Default.LogMode(logger.Info),
})
if err != nil {
    panic("数据库连接失败")
}

// 自动迁移
err = db.AutoMigrate(&Order{}, &User{}, &OrderItem{})
if err != nil {
    panic("自动迁移失败")
}

1.4 CRUD 基本操作

1.4.1 创建（Create）

// 单条创建
order := Order{OrderNo: "ORD20250101001", UserID: 1001, Amount: 299.99}
result := db.Create(&order)
fmt.Println(result.RowsAffected) // 影响行数
fmt.Println(order.ID)            // 回填主键

// 批量创建
orders := []Order{
    {OrderNo: "ORD20250101002", UserID: 1001, Amount: 199.99},
    {OrderNo: "ORD20250101003", UserID: 1002, Amount: 399.99},
}
db.Create(&orders)

1.4.2 查询（Read）

// 根据主键查询
var order Order
db.First(&order, 1) // SELECT * FROM orders WHERE id = 1

// 条件查询
db.Where("user_id = ? AND status = ?", 1001, 1).Find(&orders)

// 使用结构体查询（零值字段会被忽略）
db.Where(&Order{UserID: 1001, Status: 0}).Find(&orders)

// 指定查询字段
db.Select("id, order_no, amount").Where("user_id = ?", 1001).Find(&orders)

1.4.3 更新（Update）

// 更新单个字段
db.Model(&order).Update("status", 2)

// 更新多个字段
db.Model(&order).Updates(Order{Status: 3, Amount: 259.99})

// 使用 map 更新（不会忽略零值）
db.Model(&order).Updates(map[string]interface{}{
    "status": 0,
    "amount": 0,
})

1.4.4 删除（Delete）

// 软删除（模型包含 DeletedAt 字段）
db.Delete(&order, 1) // UPDATE orders SET deleted_at = NOW() WHERE id = 1

// 物理删除
db.Unscoped().Delete(&order, 1) // DELETE FROM orders WHERE id = 1

// 条件删除
db.Where("status = ?", -1).Delete(&Order{})

1.5 GORM 核心流程与链式调用

GORM 的链式调用遵循“会话复制”模式：每次调用返回新的 *gorm.DB 实例，避免污染原始会话。以下 SVG 展示了 GORM 从模型定义到数据持久化的完整链路：

1.6 常见 CRUD 模式对比