GORM CRUD 查询#

两种 API 风格#

风格	错误返回	类型安全	适合场景
Traditional API	`result.Error`	依赖目标结构体和运行时	兼容已有项目、复杂链式查询
Generics API	操作直接返回 `error`	`gorm.G[T]` 提供更明确的类型	新代码、希望减少 `.Error` 遗漏

两种 API 可以共用同一个 *gorm.DB，不要在同一函数里无理由混用。

Create#

1
user := User{Name: "Alice", Email: "alice@example.com"}
2
result := db.Create(&user)
3
if result.Error != nil {
4
  return result.Error
5
}
6
fmt.Println(user.ID, result.RowsAffected)

批量创建：

1
users := []User{
2
  {Name: "Alice", Email: "alice@example.com"},
3
  {Name: "Bob", Email: "bob@example.com"},
4
}
5
if err := db.CreateInBatches(&users, 100).Error; err != nil {
6
  return err
7
}

只写入指定字段：

1
db.Select("Name", "Email").Create(&user)
2
db.Omit("UpdatedAt").Create(&user)

Read#

1
var user User
2
if err := db.First(&user, 10).Error; err != nil {
3
  if errors.Is(err, gorm.ErrRecordNotFound) {
4
    // 没找到记录
5
  }
6
  return err
7
}
8

9
var users []User
10
result := db.Where("age >= ?", 18).
11
  Order("created_at DESC").
12
  Find(&users)
13
if result.Error != nil {
14
  return result.Error
15
}

First 按主键或默认排序拿一条记录；Take 不保证排序；Find 用于多条记录。不要把 Find 当成“肯定找到一条”的方法。

Generics API：

1
ctx := context.Background()
2
user, err := gorm.G[User](db).Where("id = ?", 10).First(ctx)
3
users, err := gorm.G[User](db).
4
  Where("age >= ?", 18).
5
  Order("created_at DESC").
6
  Find(ctx)

Update#

更新单列：

1
result := db.Model(&user).Update("name", "Carol")

结构体更新：

1
// 默认跳过结构体零值，例如 Age=0 可能不会被更新
2
result := db.Model(&user).Updates(User{Name: "Carol", Age: 20})
3

4
// 需要明确更新零值时使用 map
5
result = db.Model(&user).Updates(map[string]any{
6
  "name": "Carol",
7
  "age":  0,
8
})

批量更新必须带条件：

1
result := db.Model(&User{}).
2
  Where("status = ?", "inactive").
3
  Updates(map[string]any{"archived": true})
4
if errors.Is(result.Error, gorm.ErrMissingWhereClause) {
5
  // GORM 阻止了无条件批量更新
6
}

Delete#

1
if err := db.Delete(&user).Error; err != nil {
2
  return err
3
}
4

5
// 按主键删除
6
db.Delete(&User{}, user.ID)
7

8
// 批量删除必须带条件
9
db.Where("status = ?", "inactive").Delete(&User{})

使用 gorm.DeletedAt 时，上面的删除是软删除；需要物理删除必须显式使用 Unscoped()。

安全边界#

所有用户输入都通过 ?、命名参数、结构体或 map 传递，不要字符串拼接 SQL 值。
更新和删除默认要求条件；不要为了省事全局打开 AllowGlobalUpdate。
RowsAffected 只能说明受影响行数，不等同于业务成功，仍要检查 Error。
Save 会保存全部字段，可能覆盖不希望修改的列；局部修改优先使用 Select、Updates。

复用查询对象的坑#

链式方法会在 statement 中累积条件。更安全的方式是从干净的 db 开始每个逻辑查询，或使用 Session：

1
base := db.Where("tenant_id = ?", tenantID)
2

3
var active []User
4
base.Session(&gorm.Session{}).
5
  Where("status = ?", "active").
6
  Find(&active)
7

8
var disabled []User
9
base.Session(&gorm.Session{}).
10
  Where("status = ?", "disabled").
11
  Find(&disabled)

不要把一个已经附带业务条件的 *gorm.DB 当成全局可变查询对象反复复用。

HikariTish

GORM CRUD 查询#

两种 API 风格#

Create#

Read#

Update#

Delete#

安全边界#

复用查询对象的坑#

官方资料#

继续阅读

换条路线

HikariTish

GORM CRUD 查询#

两种 API 风格#

Create#

Read#

Update#

Delete#

安全边界#

复用查询对象的坑#

官方资料#

分享文章

沿着主题读

换条路线