Golang中PATCH请求无法将ClientActive布尔值设为False的问题

问题原因 #

Gorm 的 Updates 方法使用结构体作为更新参数时，默认会忽略零值字段。布尔类型的零值是 false，所以当你尝试将 ClientActive 从 true 更新为 false 时，Gorm 会判定该字段为零值，不会生成对应的更新 SQL，导致数据库中的值无法被修改。

解决方案 #

提供三种可行的解决方式，任选其一即可：

1. 使用 map 传递更新数据 #

Gorm 不会忽略 map 中的零值，因此可以将更新字段封装为 map 类型：

func ClientUpdate(c *fiber.Ctx) error {
    slug := c.Params("slug")

    var data models.Client
    err := c.BodyParser(&data)
    if err != nil {
        return err
    }

    updateData := map[string]interface{}{
        "ClientName":     data.ClientName,
        "Address":        data.Address,
        "Address2":       data.Address2,
        "Phone":          data.Phone,
        "PrimaryEmail":   data.PrimaryEmail,
        "SecondaryEmail": data.SecondaryEmail,
        "ClientActive":   data.ClientActive,
    }

    err = database.DB.Model(&models.Client{}).Where("slug = ?", slug).Updates(updateData).Error
    if err != nil {
        return err
    }

    return c.JSON(updateData)
}

2. 使用 Select 强制指定更新字段 #

通过 Select 方法明确列出所有需要更新的字段，强制 Gorm 处理零值字段：

func ClientUpdate(c *fiber.Ctx) error {
    slug := c.Params("slug")

    var data models.Client
    err := c.BodyParser(&data)
    if err != nil {
        return err
    }

    client := &models.Client{
        ClientName:     data.ClientName,
        Address:        data.Address,
        Address2:       data.Address2,
        Phone:          data.Phone,
        PrimaryEmail:   data.PrimaryEmail,
        SecondaryEmail: data.SecondaryEmail,
        ClientActive:   data.ClientActive,
    }

    // 明确指定所有需要更新的字段
    err = database.DB.Model(&models.Client{}).Where("slug = ?", slug).
        Select("ClientName", "Address", "Address2", "Phone", "PrimaryEmail", "SecondaryEmail", "ClientActive").
        Updates(&client).Error
    if err != nil {
        return err
    }

    return c.JSON(client)
}

3. 将模型字段改为指针类型 #

修改 Client 模型中的 ClientActive 为指针类型 *bool，此时 false 不再是零值（指针的零值是 nil），Gorm 会正常处理该字段的更新：

// models/Client.go
type Client struct {
    gorm.Model
    Slug           string `json:"slug" gorm:"unique"`
    ClientName     string `json:"client_name"`
    Address        string `json:"address,omitempty"`
    Address2       string `json:"address_2,omitempty" gorm:"null"`
    Phone          string `json:"phone" gorm:"null"`
    PrimaryEmail   string `json:"primary_email" gorm:"null"`
    SecondaryEmail string `json:"secondary_email" gorm:"null"`
    ClientActive   *bool  `json:"client_active" gorm:"default:true"` // 修改为指针类型
    Contacts       []Contact
    Devices        []Device
}

验证 #

使用任意一种方案后，重新测试 ClientActive 从 true 改为 false 的场景，数据库中的值应该能正常更新。

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