怎么在Golang项目中使用GORM框架做软删除-Golang-PHP中文网

软删除字段必须是gorm.deletedat类型且命名为deletedat，否则gorm不启用软删；启用后find/first等自动过滤已删记录，delete执行update而非delete，unscoped()可绕过软删。

怎么在golang项目中使用gorm框架做软删除

软删除字段必须是 `gorm.DeletedAt` 类型

GORM 的软删除机制默认只识别名为 DeletedAt 且类型为 gorm.DeletedAt（即 *time.Time）的字段。如果你自定义字段名（比如 IsDeleted 或 DeletedTime），GORM 不会自动启用软删除逻辑，查询、更新、删除都会当作普通字段处理。

正确写法：

type User struct {
    ID        uint           `gorm:"primaryKey"`
    Name      string
    DeletedAt gorm.DeletedAt `gorm:"index"` // 必须叫 DeletedAt，且用 gorm.DeletedAt 类型
}

常见错误现象：

调用 db.Delete(&user) 后数据库记录直接被物理删除（没走软删）
db.First(&user, 1) 查到已“删除”的记录，不自动过滤
手动加 WHERE deleted_at IS NULL 才能查活跃数据 —— 说明软删没生效

启用软删除后，`Find`/`First` 默认自动过滤已删除记录

只要模型含合法的 DeletedAt 字段，GORM 会在所有读取操作（Find、First、Take、Count 等）自动追加 WHERE deleted_at IS NULL 条件。你不需要手动写 Unscoped() 以外的任何额外逻辑来“屏蔽”软删数据。

但要注意例外场景：

db.Unscoped().Find(&users)：绕过软删，查全部（含已删）
db.Unscoped().Where("deleted_at IS NOT NULL").Find(&users)：专门查已删记录
关联查询（如 Preload）中，被预加载的子表若也有 DeletedAt，同样受软删影响 —— 这是默认行为，不是 bug

性能提示：GORM 不会为 DeletedAt 字段自动建索引，高并发软删场景下建议显式加索引（如上面示例中的 gorm:"index"）。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

`Delete` 方法触发软删除，`Unscoped().Delete` 才是物理删除

对含 DeletedAt 字段的模型调用 db.Delete()，GORM 实际执行的是 UPDATE ... SET deleted_at = NOW()，而非 DELETE FROM。这是软删除的核心动作。

实操要点：

db.Delete(&user, 1) → 软删（更新 DeletedAt）
db.Unscoped().Delete(&user, 1) → 物理删（真正从表中移除）
db.Unscoped().Where("id = ?", 1).Delete(&User{}) → 同样是物理删，注意 Unscoped() 要在 Delete() 前链式调用
如果想批量恢复（取消软删），用 db.Unscoped().Model(&User{}).Where("deleted_at IS NOT NULL").Update("deleted_at", nil)