4. 字段类型映射：Go类型到数据库类型的映射、自定义字段类型、字段长度与精度控制

在 GORM 迁移中，字段类型映射是连接 Go 语言静态类型系统与数据库列定义的核心桥梁。错误的映射会导致数据截断、精度丢失或查询性能下降。本章将深入剖析默认映射规则、自定义类型注册以及长度/精度控制策略。

4.1 默认类型映射表

GORM 根据 Go 类型自动推断数据库列类型。下表列出了最常用的映射关系（以 MySQL 为例，其他数据库类似但存在方言差异）：

4.2 自定义字段类型与类型覆盖

当内置映射无法满足业务语义时，GORM 提供三种覆盖机制：

1. 标签覆盖：使用 gorm:"type:..." 直接指定数据库类型。
2. 实现 Scanner/Valuer 接口：为自定义 Go 类型定义序列化行为。
3. 全局注册类型别名：通过 gorm.RegisterDataType 扩展映射表。

4.2.1 标签覆盖示例

type Product struct {
    Price    float64   `gorm:"type:DECIMAL(10,2)"`   // 精确货币
    Metadata string    `gorm:"type:JSON"`             // 强制 JSON 列
    Status   int8      `gorm:"type:ENUM('active','inactive')"` // 枚举
}

4.2.2 自定义 JSON 类型

type StringArray []string

// 实现 sql.Scanner
func (sa *StringArray) Scan(src interface{}) error {
    if src == nil {
        *sa = nil
        return nil
    }
    return json.Unmarshal(src.([]byte), sa)
}

// 实现 driver.Valuer
func (sa StringArray) Value() (driver.Value, error) {
    if sa == nil {
        return nil, nil
    }
    return json.Marshal(sa)
}

type Article struct {
    ID      uint
    Tags    StringArray `gorm:"type:JSON"`
}

4.3 字段长度与精度控制

长度（Length）和精度（Precision/Scale）直接影响存储空间与数据完整性。GORM 通过标签参数提供细粒度控制：

4.3.1 精度控制实战

type Order struct {
    Amount    float64   `gorm:"type:DECIMAL(12,4)"`   // 总金额，4位小数
    Rate      float64   `gorm:"type:DECIMAL(5,4)"`    // 汇率，4位小数
    CreatedAt time.Time `gorm:"precision:6"`           // 微秒级时间戳
}

4.4 类型映射架构总览

下图展示了从 Go 结构体到数据库列的完整映射链路：

4.5 契约校验清单

在迁移执行前，应通过以下检查点验证类型映射的正确性：

• 精度匹配：DECIMAL 字段的 scale 是否满足业务最小货币单位（如分→2位，厘→3位）。
• 长度边界：VARCHAR 长度是否覆盖最大输入长度（如邮箱 254、URL 2048）。
• 枚举完整性：ENUM 或 SET 类型是否包含所有合法值，且顺序与 Go 常量一致。
• 时区一致性：DATETIME 与 TIMESTAMP 的选择是否匹配应用时区策略。
• 无符号合规：业务字段（如年龄、数量）是否应使用 UNSIGNED 防止负数写入。