如何在GORM中使用数据库原生time类型？

问题原因 #

GORM对Go标准库的time.Time类型有默认映射规则，会自动映射为数据库的datetime/datetime(3)类型，即使你在tag里指定gorm:"type:time"，也会被默认规则覆盖，导致生成的表字段类型不符合预期。

可行解决方案 #

1. 自定义专属时间类型（推荐） #

定义一个只存储时间部分的自定义类型，实现GORM要求的Valuer和Scanner接口，强制让GORM将其映射为数据库的time类型：

import (
    "database/sql/driver"
    "fmt"
    "time"
)

// TimeOnly 仅存储时分秒的自定义时间类型
type TimeOnly time.Time

// Value 将TimeOnly转换为数据库可识别的格式
func (t TimeOnly) Value() (driver.Value, error) {
    return time.Time(t).Format("15:04:05"), nil
}

// Scan 将数据库返回的time类型值转换为TimeOnly
func (t *TimeOnly) Scan(value interface{}) error {
    switch v := value.(type) {
    case time.Time:
        *t = TimeOnly(v)
        return nil
    case []byte:
        parsedTime, err := time.Parse("15:04:05", string(v))
        if err != nil {
            return err
        }
        *t = TimeOnly(parsedTime)
        return nil
    case string:
        parsedTime, err := time.Parse("15:04:05", v)
        if err != nil {
            return err
        }
        *t = TimeOnly(parsedTime)
        return nil
    default:
        return fmt.Errorf("无法将类型%T转换为TimeOnly", value)
    }
}

// 修改原结构体，替换time.Time为自定义类型
type model struct {
    gorm.Model
    Time *TimeOnly `gorm:"type:time"`
}

之后执行GORM的自动迁移，生成的time字段就会是数据库的time类型。

2. 手动执行SQL创建表 #

如果不想自定义类型，可以跳过GORM的自动迁移逻辑，直接用原生SQL语句创建表，明确指定字段类型：

err := db.Exec(`CREATE TABLE IF NOT EXISTS models (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    created_at DATETIME(3) NULL,
    updated_at DATETIME(3) NULL,
    deleted_at DATETIME(3) NULL,
    time TIME NULL
)`).Error
if err != nil {
    // 处理错误
}

3. 检查依赖版本 #

确保你使用的是最新版的GORM和对应数据库驱动（比如MySQL驱动用github.com/go-sql-driver/mysql），旧版本可能存在类型映射的兼容性问题，升级后部分场景下gorm:"type:time"的tag可能会生效。

内容的提问来源于stack exchange，提问作者rhuanpk