GORM无法更新timestamp字段问题求助

问题背景 #

我定义的User模型如下：

type User struct {
    ID          uuid.UUID   `gorm:"primarykey;column:id;type:uuid;default:gen_random_uuid()"`
    FullName    string      `gorm:"column:full_name"`
    PhoneNumber string      `gorm:"column:phone_number"`
    JoinDate    pq.NullTime `gorm:"column:join_date"`
}

对应的PostgreSQL建表SQL：

CREATE TABLE IF NOT EXISTS "fellowship"."users" (
    "id"           uuid      NOT NULL DEFAULT uuid_generate_v4(),
    "full_name"    text      NOT NULL,
    "phone_number" text      NOT NULL,
    "join_date"    timestamp,
    "created_at"   timestamp NOT NULL DEFAULT NOW(),
    "updated_at"   timestamp NULL     DEFAULT NOW(),

    PRIMARY KEY ("id")
);

调用UpdateUser方法更新join_date字段时，数据库中该字段仍为NULL，但无任何报错：

func UpdateUser(user *models.User) error {
    fmt.Println("repo: user id: ", user.ID)
    fmt.Println("repo: user join date: ", user.JoinDate)

    result := tx.Save(user)

    fmt.Println("result.RowsAffected:", result.RowsAffected)
    fmt.Println("result.Error:", result.Error)

    if result.Error != nil {
        return ParseError(result.Error)
    }

    if result.RowsAffected == 0 {
        return ErrRecordNotFound
    }

    return nil
}

日志输出：

repo: user id:  2e1b0c0b-ea3f-4ddd-a022-a59cdbbcf102
repo: user join date:  {2023-09-25 00:00:00 +0000 UTC false}
result.RowsAffected: 1
result.Error: <nil>

数据库查询结果：

postgres=# select id, join_date, created_at from fellowship.users where id = '2e1b0c0b-ea3f-4ddd-a022-a59cdbbcf102';
                  id                  | join_date |         created_at         
--------------------------------------+-----------+----------------------------
 2e1b0c0b-ea3f-4ddd-a022-a59cdbbcf102 |           | 2023-08-08 15:12:37.001919
(1 row)

其他字段更新正常，仅日期字段有此问题，尝试过sql.NullTime类型，结果一致。

问题分析 #

看日志里的JoinDate输出：{2023-09-25 00:00:00 +0000 UTC false}，最后一个false是pq.NullTime的Valid字段。GORM处理NullTime类型时，会判断Valid值：如果为false，无论Time字段有什么值，都会被当作NULL写入数据库，这就是join_date始终为NULL的原因。

解决方案 #

1. 正确设置NullTime的Valid字段 #

在给JoinDate赋值时，必须将Valid设为true，告诉GORM这个时间值是有效的：

user.JoinDate = pq.NullTime{
    Time:  time.Date(2023, 9, 25, 0, 0, 0, 0, time.UTC),
    Valid: true, // 关键：标记该时间有效
}

2. 改用*time.Time类型替代NullTime #

如果不想处理Valid字段的问题，可以把模型里的JoinDate改成指针类型，这样：

• 赋值为nil时，数据库存NULL；
• 赋值为&time.Time时，数据库存对应时间；

修改后的模型：

type User struct {
    ID          uuid.UUID `gorm:"primarykey;column:id;type:uuid;default:gen_random_uuid()"`
    FullName    string    `gorm:"column:full_name"`
    PhoneNumber string    `gorm:"column:phone_number"`
    JoinDate    *time.Time `gorm:"column:join_date"`
}

赋值示例：

joinTime := time.Date(2023, 9, 25, 0, 0, 0, 0, time.UTC)
user.JoinDate = &joinTime

3. 明确指定要更新的字段（可选） #

如果坚持使用NullTime，可以在更新时用Select明确指定要更新的字段，避免GORM忽略无效值：

// 只更新join_date字段
result := tx.Model(user).Select("join_date").Updates(user)

或者用Updates传入结构体，确保字段被正确处理：

result := tx.Model(&models.User{}).Where("id = ?", user.ID).Updates(map[string]interface{}{
    "join_date": user.JoinDate,
})

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