Go语言REST API更新接口报错：WHERE conditions required

核心原因 #

GORM的Save方法执行更新时，要么需要模型实例包含主键值，要么需要通过Where明确指定更新条件，但你的写法顺序错误，且可能未正确设置主键或赋值。

正确解决方案 #

方案1：给模型实例赋值主键 #

如果你的address结构体中address_id是主键字段（需用gorm:"primaryKey"标签标记），直接把URL参数的id赋值给address.AddressID，再调用Save：

// 示例address结构体定义
type Address struct {
    AddressID uint   `gorm:"primaryKey"`
    // 其他业务字段...
}

func (s *AddressService) UpdateAddressByID(c *gin.Context) {
    idStr := c.Param("id")
    id, _ := strconv.ParseUint(idStr, 10, 32) // 根据实际类型调整转换逻辑
    
    var address Address
    if err := c.ShouldBindJSON(&address); err != nil {
        // 处理请求体绑定错误
        return
    }
    // 赋值主键，让GORM自动生成WHERE条件
    address.AddressID = uint(id)
    
    if err := s.DB.Save(&address).Error; err != nil {
        // 处理DB操作错误
        return
    }
    // 返回成功响应
}

方案2：正确使用Where+Updates（不依赖主键场景） #

如果不需要依赖主键更新，必须先调用Where指定条件，再调用Updates（而非Save），Updates配合Where是更明确的定向更新方式：

func (s *AddressService) UpdateAddressByID(c *gin.Context) {
    id := c.Param("id")
    var updatePayload map[string]interface{}
    
    if err := c.ShouldBindJSON(&updatePayload); err != nil {
        // 处理绑定错误
        return
    }
    // 先指定WHERE条件，再执行更新
    if err := s.DB.Where("address_id = ?", id).Updates(updatePayload).Error; err != nil {
        // 处理DB错误
        return
    }
    // 返回成功响应
}

为什么你的写法无效？ #

你写的s.DB.Save(&address).Where("address_id = ?", id)顺序错误：Save方法会立即执行SQL操作，后续的Where不会对本次更新生效；同时address实例未携带主键值，GORM无法自动生成WHERE条件，因此触发报错。

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