如何在Gorm中实现数据库为null时datatypes.Date返回空字符串

方案一：自定义包装类型并实现序列化与数据库交互接口 #

通过包装datatypes.Date，完全控制字段的JSON序列化逻辑和数据库读写行为，是最稳妥的方案。

import (
    "database/sql/driver"
    "encoding/json"
    "fmt"
    "time"

    "gorm.io/datatypes"
)

// 自定义日期类型，包装datatypes.Date
type CustomDate datatypes.Date

// MarshalJSON 实现自定义JSON序列化逻辑
func (d CustomDate) MarshalJSON() ([]byte, error) {
    date := datatypes.Date(d)
    // 判断是否为零值（对应数据库中的null）
    if date.IsZero() {
        return []byte(`""`), nil
    }
    // 正常返回格式化的日期字符串
    return []byte(fmt.Sprintf(`"%s"`, date.Format(time.DateOnly))), nil
}

// UnmarshalJSON 实现反序列化（按需添加，若需接收前端空字符串转为null）
func (d *CustomDate) UnmarshalJSON(data []byte) error {
    var s string
    if err := json.Unmarshal(data, &s); err != nil {
        return err
    }
    if s == "" {
        *d = CustomDate(datatypes.Date{})
        return nil
    }
    date, err := time.Parse(time.DateOnly, s)
    if err != nil {
        return err
    }
    *d = CustomDate(datatypes.Date(date))
    return nil
}

// Scan 实现Gorm Scanner接口，处理数据库读取逻辑
func (d *CustomDate) Scan(value interface{}) error {
    var date datatypes.Date
    if err := date.Scan(value); err != nil {
        return err
    }
    *d = CustomDate(date)
    return nil
}

// Value 实现Gorm Valuer接口，处理数据库写入逻辑
func (d CustomDate) Value() (driver.Value, error) {
    date := datatypes.Date(d)
    if date.IsZero() {
        return nil, nil
    }
    return date.Value()
}

// 修改User结构体的BirthDate字段类型为自定义类型
type User struct {
    ID        uint       `json:"id" gorm:"primaryKey"`
    Name      string     `json:"name"`
    BirthDate CustomDate `json:"birthDate" gorm:"default:null"`
}

方案二：给User结构体实现自定义MarshalJSON #

如果不想新增包装类型，可以直接给User结构体写序列化方法，重写指定字段的输出值：

func (u User) MarshalJSON() ([]byte, error) {
    // 定义匿名结构体继承User的所有字段
    type Alias User
    // 重写BirthDate字段的类型和值
    return json.Marshal(struct {
        Alias
        BirthDate string `json:"birthDate"`
    }{
        Alias:     Alias(u),
        BirthDate: func() string {
            if u.BirthDate.IsZero() {
                return ""
            }
            return u.BirthDate.Format(time.DateOnly)
        }(),
    })
}

注意事项 #

• 两种方案都依赖datatypes.Date的零值对应数据库的null，确保Gorm标签gorm:"default:null"配置正确，写入数据库时零值会被转为null。
• 若使用方案一，需确保自定义类型的所有接口方法实现正确，避免数据库读写异常。

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