Revel框架软删除机制的使用教程

云晨小哥_2318

云晨小哥_2318

2026-11-10

661人浏览

原创

Revel 框架不提供软删除抽象层,需手动启用 GORM 的 DeletedAt 字段并显式校验;User.Find() 查不到已删记录因 GORM v2 自动追加 WHERE deleted_at IS NULL,而 raw SQL 不触发该逻辑;恢复软删记录须用 Unscoped().Where(...).First().UpdateColumn("deleted_at", nil) 并检查 RowsAffected。

revel框架软删除机制的使用教程

Revel 框架本身不提供软删除抽象层,GORM 的 DeletedAt 字段必须由你显式启用、手动校验,并在所有查询中确保未被意外绕过——否则数据会“物理消失”或“查不到但其实存在”。

为什么 User.Find() 查不到已删记录,但 raw SQL 能查到

这是 GORM v2 默认启用软删除钩子导致的:只要模型含 gorm.DeletedAt 字段且类型为 *time.Time,所有 Find、First、Where 等查询自动追加 WHERE deleted_at IS NULL 条件。而原生 db.Raw() 或 db.Table().Select() 不走 GORM 查询构建器,自然不触发该逻辑。

  • 检查你的模型是否真包含该字段:DeletedAt gorm.DeletedAt `gorm:"index"`(注意 tag 名必须是 gorm:"index",仅写 gorm:"-" 会禁用软删除)
  • 若想临时查出已软删记录,必须显式调用 Unscoped():db.Unscoped().First(&user, id)
  • 别在控制器里无条件用 Unscoped()——它会绕过所有软删除保护,暴露脏数据

如何安全恢复一条软删除记录

恢复不是“反向 delete”,而是把 DeletedAt 设为 nil。GORM 不提供 Restore() 方法,必须手写更新逻辑。

Revel框架 0.19.0
Revel框架 0.19.0

Revel框架 0.19.0 版本源码包下载,适合关注 Referrer-Policy、vendor 识别、Gorp 事务抽象和 CSRF 修复的开发团队。

下载
  • 不能只写 db.Model(&user).Update("deleted_at", nil) —— 这会跳过 GORM 的钩子(如 BeforeUpdate),且不校验记录是否存在
  • 推荐做法:先查再改,确保原子性与存在性:db.Unscoped().Where("id = ? AND deleted_at IS NOT NULL", id).First(&user).UpdateColumn("deleted_at", nil)
  • UpdateColumn 直接生成 SQL 更新,不触发回调和验证;Update 则会跑完整生命周期,可能因其他字段为空而失败
  • 操作后务必检查 result.RowsAffected,为 0 表示该记录根本没被软删过,或 ID 不存在

软删除 + Revel Controller 的常见坑

Revel 的 controller 层对 DeletedAt 完全无感,不会自动过滤、也不会自动设置。所有软删除语义都得你一手托底。

  • CRUD 模板生成的 Destroy 方法默认调用 db.Delete() —— 这会软删,但前端点击“删除”后页面没反馈是否成功,因为没检查 result.Error 和 result.RowsAffected
  • 列表页(List)若直接用 db.Find(&users),用户看不到已删数据,这通常符合预期;但若要做“回收站”功能,就必须用 Unscoped().Where("deleted_at IS NOT NULL") 显式查
  • 别在 model 文件里写 func (u *User) Delete(db *gorm.DB) error { return db.Delete(u).Error } —— 这看似封装,实则掩盖了软删/硬删歧义;应拆成 DeleteSoft 和 DeleteHard 两个明确函数
  • 事务中执行软删除时,记得 Unscoped() 只作用于当前链式调用,不会污染后续语句

最易被忽略的是:GORM 的软删除只作用于主表字段,关联查询(如 Preload("Orders"))不会自动给 Orders 表加 deleted_at IS NULL 条件。如果订单表也有软删除字段,必须手动 Preload("Orders", "deleted_at IS NULL"),否则会拉出已被删的订单。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang Beego框架
Golang Beego框架

本专题聚焦 Golang 全栈式 Web 框架 Beego 的学习与实战,内容涵盖 MVC 模式、路由控制、ORM 数据库操作、模块化开发、日志管理与 RESTful API 构建。通过企业管理系统、电商后端与微服务架构等实战案例,帮助学员掌握使用 Beego 高效开发企业级应用的核心能力。

2025.08.27

4100

8

go语言 beego框架
go语言 beego框架

本专题整合了go语言中beego框架相关内容,阅读专题下的文章了解更多详细内容。

2025.09.10

7961

12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

40

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

20

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

20

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

40

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

40

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

40

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

40

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习