1. GORM入门

本章是《Go Web 服务数据边界：GORM 模型关联与事务边界设计》的第一节，我们将从最基础的 ORM 概念出发，逐步搭建 GORM 开发环境，并完成与 MySQL 数据库的首次连接。理解这些前置知识，是后续掌握模型关联与事务边界设计的基石。

1.1 ORM 概念：对象与关系之间的桥梁

ORM（Object-Relational Mapping，对象关系映射）是一种编程技术，用于在面向对象编程语言（如 Go）的关系型数据库（如 MySQL）之间建立映射关系。它允许开发者使用面向对象的方式操作数据库，而无需直接编写 SQL 语句。

使用 ORM 的核心优势在于：

• 开发效率：避免编写大量重复的 SQL 语句，代码更简洁。
• 可维护性：数据操作逻辑集中在模型层，业务变更时影响范围小。
• 数据库无关性：切换数据库（如从 MySQL 到 PostgreSQL）时，只需更换驱动，业务代码改动极小。

1.2 GORM 特性概览

GORM 是 Go 语言生态中最流行的 ORM 库之一，以其功能全面、社区活跃和良好的文档著称。以下是其核心特性：

• 全功能 ORM：支持 CRUD、关联（Has One、Has Many、Belongs To、Many To Many）、预加载、事务、复合主键等。
• 自动迁移：根据 Go 结构体自动创建、更新数据库表结构，降低 DDL 维护成本。
• 链式调用 API：提供流畅的查询构建器，支持条件、排序、分页、分组等。
• 钩子（Hooks）：在 CRUD 操作前后插入自定义逻辑（如 BeforeCreate、AfterUpdate）。
• 日志与性能：内置日志记录器，支持慢查询追踪和 SQL 语句打印。
• 扩展性：支持插件机制（如分库分表、读写分离），并兼容多种数据库驱动。

1.3 GORM 安装与数据库驱动配置

GORM 采用模块化设计，核心库仅提供 ORM 框架，数据库驱动需要单独安装。以下是安装步骤：

1. 初始化 Go 模块（如果尚未初始化）：

   go mod init your-project-name

2. 安装 GORM 核心库：

   go get -u gorm.io/gorm

3. 安装 MySQL 驱动：

   go get -u gorm.io/driver/mysql

安装完成后，go.mod 文件中应包含以下依赖：

require (
    gorm.io/driver/mysql v1.5.7
    gorm.io/gorm v1.25.12
)

1.4 快速连接 MySQL

连接 MySQL 需要配置 DSN（Data Source Name，数据源名称）。DSN 的格式如下：

username:password@tcp(host:port)/dbname?charset=utf8mb4&parseTime=True&loc=Local

以下是一个完整的连接示例：

package main

import (
    "fmt"
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
)

func main() {
    dsn := "root:your_password@tcp(127.0.0.1:3306)/test_db?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("连接数据库失败: " + err.Error())
    }
    fmt.Println("数据库连接成功！")
}

1.5 GORM 连接与 ORM 工作流程

下图展示了从 Go 结构体到 MySQL 表的完整映射流程，以及 GORM 在其中的桥梁作用：

1.6 验证连接与常见问题

连接成功后，可以通过以下方式验证：

// 获取底层 sql.DB 对象，用于设置连接池参数
sqlDB, err := db.DB()
if err != nil {
    panic(err)
}

// 设置连接池参数
sqlDB.SetMaxIdleConns(10)   // 最大空闲连接数
sqlDB.SetMaxOpenConns(100)  // 最大打开连接数
sqlDB.SetConnMaxLifetime(time.Hour) // 连接最大复用时间

// Ping 数据库
err = sqlDB.Ping()
if err != nil {
    panic("数据库无法访问: " + err.Error())
}
fmt.Println("数据库连接池配置成功！")