Laravel 8 如何查询cascade delete影响的关联模型与数据列

首先要明确，Laravel项目里的级联删除通常分两类：Eloquent模型层配置的级联删除、数据库层面外键配置的级联删除，两类场景需要分开处理才能拿到完整的受影响数据：

1. 处理Eloquent模型层的级联关联 #

这部分是你在模型关系、boot方法、模型观察者中定义的级联删除逻辑，是最容易精准统计的部分，不建议用反射遍历模型所有关系（会把没有配置级联的普通关联误算进去，性能也差），推荐用显式配置的方式实现：

• 第一步：在所有业务模型继承的基类中，统一加级联关联配置属性和读取方法

// app/Models/BaseModel.php
protected array $cascadeDeletes = [];

public function getCascadeDeleteRelations(): array
{
    return $this->cascadeDeletes;
}

• 第二步：每个存在级联删除的模型，把需要级联删除的关联名填入配置，比如文章模型需要级联删评论、附件：

// app/Models/Post.php
protected array $cascadeDeletes = ['comments', 'attachments'];

public function comments()
{
    return $this->hasMany(Comment::class);
}

public function attachments()
{
    return $this->morphMany(Attachment::class, 'attachable');
}

• 第三步：写通用递归方法，遍历所有级联关联，拿到受影响的模型、表名、外键、待删除数据量

/**
 * 递归查询模型级联删除影响的所有关联数据
 * @param Model $model 待删除的模型实例
 * @param array $affected 结果集（引用传值用于递归）
 * @return array
 */
function getCascadeDeleteAffected(Model $model, array &$affected = []): array
{
    foreach ($model->getCascadeDeleteRelations() as $relationName) {
        $relation = $model->$relationName();
        $relatedModel = $relation->getRelated();
        $relatedTable = $relatedModel->getTable();
        $foreignKey = $relation->getForeignKeyName();
        // 统计当前关联下会被删除的数据条数，注意clone查询构造器避免污染原模型关联
        $count = (clone $relation)->count();

        $affected[] = [
            'model' => get_class($relatedModel),
            'table' => $relatedTable,
            'foreign_key' => $foreignKey,
            'affected_count' => $count,
        ];

        // 存在关联数据时，递归查询下一级的级联影响
        if ($count > 0) {
            foreach ((clone $relation)->get() as $relatedItem) {
                if (method_exists($relatedItem, 'getCascadeDeleteRelations')) {
                    getCascadeDeleteAffected($relatedItem, $affected);
                }
            }
        }
    }
    // 按表+外键去重，避免多态关联、同表关联重复统计
    return collect($affected)->unique(fn($item) => $item['table'].$item['foreign_key'])->values()->toArray();
}

2. 处理数据库层面的外键级联 #

如果你的部分级联删除是直接在迁移里通过外键->onDelete('cascade')配置的（这部分逻辑走数据库底层执行，不会触发Eloquent模型事件），需要直接查询系统表拿关联关系：

/**
 * 查询指定表在数据库层面配置的级联删除外键
 * @param string $tableName 待删除数据所在表名
 * @return array
 */
function getDbLevelCascadeAffected(string $tableName): array
{
    return DB::select("
        SELECT 
            TABLE_NAME as child_table,
            COLUMN_NAME as foreign_key_column,
            CONSTRAINT_NAME as constraint_name
        FROM information_schema.REFERENTIAL_CONSTRAINTS
        LEFT JOIN information_schema.KEY_COLUMN_USAGE 
            ON REFERENTIAL_CONSTRAINTS.CONSTRAINT_NAME = KEY_COLUMN_USAGE.CONSTRAINT_NAME
        WHERE REFERENTIAL_CONSTRAINTS.CONSTRAINT_SCHEMA = DATABASE()
          AND REFERENCED_TABLE_NAME = ?
          AND DELETE_RULE = 'CASCADE'
    ", [$tableName]);
}

注意：数据库级联的关联数据量需要额外拼接查询条件统计，比如查到外键是post_id关联posts表，就按当前待删除记录的ID去子表查where('post_id', $post->id)->count()拿到实际影响条数。

3. 前端删除提示实现逻辑 #

• 用户点击删除按钮时，先发送AJAX预查询请求，把待删除的模型ID传到后端
• 后端合并上述两个方法的查询结果，整理成结构化的受影响数据返回，格式参考：

  [
      ['table' => 'comments', 'foreign_key' => 'post_id', 'affected_count' => 12, 'label' => '评论'],
      ['table' => 'attachments', 'foreign_key' => 'attachable_id', 'affected_count' => 3, 'label' => '附件'],
  ]
  

• 前端弹出确认框，把每一项会被同步删除的数据类型、数量明确列出来，用户确认后再发送真正的删除请求即可。

常见避坑点 #

• 软删除场景要注意：如果级联逻辑是通过模型事件触发的，软删除时也会执行，统计时要区分永久删除和软删除的影响范围
• 多态关联统计时，除了外键ID字段，还要加上关联类型字段的查询条件，否则会统计到其他类型的关联数据
• 不要通过反射遍历模型所有关系判断级联，大部分普通关联没有配置级联规则，遍历出来的结果会出现大量误报

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