0

0

如何在Laravel中使用软删除恢复

畫卷琴夢

畫卷琴夢

发布时间:2025-07-16 12:36:03

|

391人浏览过

|

来源于php中文网

原创

laravel中恢复软删除数据的方法主要有两种:对单个模型调用restore()方法,或通过withtrashed()查询后调用restore()批量恢复。1. 恢复单个模型:使用withtrashed()->find()获取软删除记录,再调用restore()将其deleted_at设为null;2. 批量恢复:通过withtrashed()结合where条件查询软删除数据,再调用restore()进行批量更新,返回受影响行数;3. 注意事项包括性能问题需分批处理、关联模型不会自动恢复需手动处理、唯一性约束可能引发冲突需提前检查,且复杂操作建议使用事务确保一致性。

如何在Laravel中使用软删除恢复

在Laravel里,想把那些被“软删除”的数据找回来,其实就是那么几招:要么直接在某个模型实例上调用restore()方法,要么就是在查询的时候,先用withTrashed()把它们都捞出来,再跟着一个restore()。听起来简单,但里头还是有些门道的,尤其是在处理关联数据或者批量操作时,需要多留个心眼。

解决方案

当你需要恢复Laravel中被软删除的记录时,核心操作围绕着restore()方法。这方法其实就是把模型实例的deleted_at字段设回null,并更新updated_at时间戳。

恢复单个模型实例: 这是最直接的方式。你首先需要通过某种方式找到那条被软删除的记录。注意,常规的find()get()方法默认是不会查询到软删除记录的。你需要使用withTrashed()

use App\Models\Post; // 假设你的模型是Post

// 找到一条被软删除的帖子
$post = Post::withTrashed()->find(1);

if ($post) {
    $post->restore(); // 调用 restore() 方法
    // 此时,$post 已经被恢复,deleted_at 字段变为 null
    // 你可以检查 $post->trashed() 会返回 false
    echo "帖子 ID: {$post->id} 已成功恢复。";
} else {
    echo "未找到该帖子,或者它并未被软删除。";
}

我个人觉得,这种方式在处理用户误删或单个数据回溯时特别顺手,直观且不容易出错。

恢复多条或批量模型实例: 如果你需要根据某个条件批量恢复数据,比如恢复某个用户所有被删除的评论,或者在某个时间段内被删除的所有文章,你可以在查询构建器上直接链式调用restore()

use App\Models\Comment; // 假设你的模型是Comment

// 恢复用户ID为5的所有被软删除的评论
$affectedRows = Comment::withTrashed()
                       ->where('user_id', 5)
                       ->restore();

echo "成功恢复了 {$affectedRows} 条评论。";

// 恢复所有在特定日期之后被软删除的帖子
use App\Models\Article; // 假设你的模型是Article

$affectedArticles = Article::withTrashed()
                           ->where('deleted_at', '>', '2023-01-01 00:00:00')
                           ->restore();

echo "成功恢复了 {$affectedArticles} 篇文章。";

这里值得注意的是,restore()方法在查询构建器上调用时,会返回受影响的行数。这对于批量操作后的反馈很有用。我经常用它来确认操作是否按预期执行,或者在日志中记录。

软删除与硬删除:我该如何抉择?

这真是个老生常谈但又不得不提的问题。在项目初期,很多人会纠结到底是用软删除还是直接硬删除。我的看法是,这取决于你的业务需求和数据敏感度。

软删除(Soft Deletes),顾名思义,它并没有真正从数据库中删除数据,只是给记录打上了一个“已删除”的标记(通常是deleted_at字段被填充)。这样做的好处显而易见:

  • 数据可恢复性: 误删是常有的事,软删除给了你后悔药。用户不小心删了个重要文件?管理员手滑删了个用户?软删除能让你轻松找回。这在很多业务场景下是强制要求,比如电商订单、用户资料等。
  • 审计和历史记录: 有时候,你需要知道某条数据曾经存在过,或者在什么时间被“删除”的。软删除能保留这种历史痕迹,方便后续的审计或数据分析。
  • 关联数据处理: 当一条记录被删除时,它可能有很多关联数据。硬删除可能导致级联删除,或者留下悬空的外键。软删除则能避免这些复杂性,因为数据还在那里,只是被标记为不可见。

然而,软删除也有其缺点

  • 数据库体积膨胀: 那些被“删除”的数据依然占据着存储空间。如果你的系统数据量巨大且删除频繁,这会是个问题。
  • 查询复杂度增加: 默认情况下,Laravel的Eloquent查询会自动排除软删除的记录。但如果你需要查询所有数据(包括软删除的),就需要额外的withTrashed()方法,这在某些复杂查询中可能会稍微增加心智负担。
  • 唯一性约束问题: 假设你有一个email字段需要唯一。如果一个用户被软删除了,他的邮箱还在数据库里,那么新用户就不能注册这个邮箱。你可能需要针对性地处理唯一性约束,比如在唯一索引上加上where deleted_at IS NULL的条件,或者在应用层面做额外检查。

硬删除(Hard Deletes)就是直接从数据库中移除记录。它的优点是:

  • 数据库精简: 真正释放存储空间,保持数据库的“干净”。
  • 查询效率: 没有额外的deleted_at字段过滤,理论上查询更直接。

但缺点也同样明显:数据一旦删除,就不可恢复

我的建议是: 凡是涉及用户核心数据、交易记录、或者未来可能需要回溯的数据,无脑选择软删除。对于那些临时性、不重要、或者生成后就不再需要的数据(比如某些日志、缓存),硬删除更合适。这没有绝对的对错,关键在于理解各自的利弊,并结合具体业务场景做出最适合的决策。

批量恢复软删除数据,有哪些坑要避开?

批量恢复数据,听起来很酷,一行代码搞定几百上千条记录。但实际操作中,确实有些“坑”需要注意,否则可能会给你带来意想不到的麻烦。

1. 性能问题: 当你批量恢复大量数据时,比如几十万条,这会给数据库带来不小的压力。每次restore()操作都会触发数据库的UPDATE语句,如果并发量大,或者表上有复杂的索引和触发器,可能会导致数据库锁表,甚至拖慢整个系统。

  • 解决方案: 考虑分批处理(chunking)。例如,每次只恢复1000条记录,然后暂停一下。或者在业务低峰期执行。

    // 假设要恢复所有被软删除的订单
    Order::withTrashed()
        ->whereNotNull('deleted_at') // 确保只处理被软删除的
        ->chunkById(1000, function ($orders) {
            foreach ($orders as $order) {
                $order->restore();
            }
            // 可以在这里加个 sleep(1) 稍微缓解数据库压力
        });

    当然,如果你的Laravel版本够新,并且你确定不需要模型事件(比如restored事件),直接使用查询构建器的restore()会更高效,因为它只执行一条SQL语句。但如果你需要模型事件触发,那就得循环调用$model->restore()。这是个取舍。

2. 关联数据的一致性: 这是个大坑。你恢复了一条父级记录,但它的子级记录呢?如果子级记录也被软删除了,它们会自动恢复吗?答案通常是:不会。Laravel的软删除机制只作用于当前模型,不会自动级联到关联模型。

  • 场景举例: 你恢复了一篇被软删除的文章,但文章下的评论如果也被软删除了,它们依然是软删除状态。用户看到文章了,却看不到评论。

    所能网络客户管理系统
    所能网络客户管理系统

    在原金领办公系统上增加的客户管理系统,其中包括客户管理,文档管理,表格管理,分超级管理员(总经办),管理员(部门经理),普通用户(员工),强大的检索功能,各种条件检索,普通用户删除的客户资料,超级管理员能在回收站中恢复,有效的保证了员工离职使客户资源丢失问题。超级管理员:ao密码:123456

    下载
  • 解决方案: 你可能需要在恢复父级记录的同时,手动恢复其关联的子级记录。这通常需要在模型中定义好关系,然后在restore()之后或在自定义的恢复方法中处理。

    class Post extends Model
    {
        use SoftDeletes;
    
        public function comments()
        {
            return $this->hasMany(Comment::class);
        }
    
        // 自定义一个恢复方法,处理关联
        public function restoreWithComments()
        {
            $this->restore(); // 恢复文章本身
            $this->comments()->withTrashed()->restore(); // 恢复所有关联的评论
        }
    }
    
    // 调用时
    $post = Post::withTrashed()->find(1);
    if ($post) {
        $post->restoreWithComments();
    }

    我个人建议,如果你的业务逻辑需要这种级联恢复,最好是把这个逻辑封装在模型方法里,或者专门的服务类里,这样既清晰又易于维护。

3. 唯一性约束冲突: 前面提过,如果你的表上有唯一性约束(比如邮箱、用户名),而软删除的记录中包含了与当前尝试插入或恢复的记录冲突的值,那么恢复操作会失败。

  • 解决方案: 这通常需要在恢复前进行检查,或者在数据库层面调整唯一索引,使其忽略被软删除的记录(例如,在MySQL中,可以创建一个复合唯一索引,包含columndeleted_at,并允许deleted_at为NULL)。但后者比较复杂,也可能不是所有数据库都支持。更常见的做法是在应用层做预判,或者在恢复失败时捕获异常并处理。

    try {
        $user = User::withTrashed()->find(10);
        if ($user) {
            // 假设邮箱是唯一的
            $existingUser = User::where('email', $user->email)->first();
            if ($existingUser && $existingUser->id !== $user->id) {
                // 如果存在相同邮箱且不是自身,说明会冲突
                throw new \Exception("邮箱 {$user->email} 已被占用,无法恢复用户 ID: {$user->id}");
            }
            $user->restore();
            echo "用户 ID: {$user->id} 已成功恢复。";
        }
    } catch (\Exception $e) {
        echo "恢复失败: " . $e->getMessage();
    }

    这种显式检查虽然增加了代码量,但在业务逻辑复杂时,能有效避免数据不一致和程序崩溃。

恢复软删除后,关联数据会发生什么变化?

这是一个非常关键的问题,也是我前面提到的“坑”的延伸。理解这一点,对于维护数据完整性至关重要。

当你在Laravel中恢复一条软删除的父级记录时,默认情况下,其关联的子级记录并不会自动恢复。它们的deleted_at字段状态保持不变。这意味着:

  1. 子级记录如果未被软删除,则保持可见: 如果父级记录被软删除时,其关联的子级记录(比如文章的评论)并没有被软删除,那么在父级记录恢复后,这些子级记录依然是可见的,并且可以正常通过关系加载。

  2. 子级记录如果也被软删除,则保持不可见: 这是最常见也最容易让人困惑的情况。如果你在删除父级记录时,也级联地软删除了子级记录(例如,通过在父模型上监听deleting事件来手动软删除子模型,或者通过数据库触发器),那么在父级记录恢复后,这些子级记录依然是“软删除”状态,通过常规关系(如$post->comments)是无法加载出来的。你必须使用withTrashed()onlyTrashed()来显式加载它们。

    $post = Post::withTrashed()->find(1);
    $post->restore(); // 文章恢复了
    
    // 此时,如果你尝试 $post->comments,你将看不到任何评论,
    // 因为关联的评论如果也被软删除,它们依然是软删除状态。
    // 你需要这样做:
    $comments = $post->comments()->withTrashed()->get();
    foreach ($comments as $comment) {
        if ($comment->trashed()) {
            $comment->restore(); // 手动恢复每条评论
        }
    }

解决方案和最佳实践:

  • 明确的级联恢复逻辑: 如果你的业务场景需要父子级联恢复,请务必在代码中显式实现。我前面给出的restoreWithComments()就是一个很好的例子。你可以在父模型上定义一个方法,负责恢复自身以及所有相关的子模型。

  • 考虑数据一致性策略: 在设计数据库和应用逻辑时,就要考虑“删除”和“恢复”操作对关联数据的影响。是父子同生共死(一起删除一起恢复),还是父死子活(父删除子保留,但通过关系不可见),或者父活子死(父恢复子依然删除)?这需要根据业务需求来决定。

  • 使用事务: 在进行复杂的恢复操作,特别是涉及多个模型和关联模型时,务必将整个恢复过程包裹在数据库事务中。这样,如果中间有任何一步失败,你可以回滚所有操作,确保数据的一致性。

    DB::transaction(function () use ($post) {
        $post->restore();
        $post->comments()->withTrashed()->restore();
        // 甚至可以恢复更多层级的关联数据
    });

    事务是数据库操作的“安全网”,在处理关键数据时,我几乎都会用到它。它能大大降低数据不一致的风险。

总而言之,Laravel的软删除机制提供了一个非常方便的起点,但它更多的是关于单个模型实例的“标记”与“取消标记”。对于更复杂的业务场景,特别是涉及多层级关联数据时,我们需要投入更多精力去设计和实现一套完整的“删除”与“恢复”策略,确保数据在任何状态下都能保持其应有的完整性和一致性。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

319

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

276

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

370

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

371

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

81

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

64

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

67

2025.08.05

数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

683

2023.10.12

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

19

2026.01.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 804人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号