Drupal 8孤立Paragraph实体未删除及数据库孤立数据问题咨询

这确实是Drupal Paragraphs模块的默认“特性”——当你删除父节点或者解除Paragraph与节点的关联时，Paragraph实体并不会被自动删除，只会变成孤立状态，时间一久数据库里就会堆积大量冗余的Paragraph及其字段数据。下面给你一套从清理现有冗余到预防未来问题的完整方案：

一、批量清理已存在的孤立Paragraph #

方法1：用Drush命令+自定义筛选（推荐） #

如果你熟悉Drush，可以先筛选出所有没有父关联的Paragraph，再批量删除：

1. 先执行SQL查询找出孤立Paragraph的ID：

SELECT p.id FROM paragraph p LEFT JOIN paragraph__parent pp ON p.id = pp.entity_id WHERE pp.entity_id IS NULL;

2. 把查询到的ID列表用Drush命令批量删除：

drush entity:delete paragraph [ID1,ID2,ID3,...]

注意：执行前一定要完整备份数据库，避免误删有用数据！

方法2：用专用模块简化操作 #

如果不想写代码或直接操作数据库，可以用Paragraphs Cleaner模块（Drupal 8兼容版本）：

• 安装启用后，它会自动检测系统中的孤立Paragraph
• 支持手动批量删除，也可以设置自动清理规则（比如每周定时清理）

方法3：通过Views批量操作 #

1. 创建一个展示Paragraph实体的视图
2. 添加过滤器，筛选出parent_id为空的Paragraph
3. 启用Views的批量操作功能，添加“删除实体”操作，批量选中孤立Paragraph后执行删除

二、设置自动清理，预防未来产生孤立Paragraph #

要从根源解决问题，可以写一段自定义代码，在父节点删除或Paragraph被移除时自动清理孤立实体：

创建一个自定义模块（比如my_paragraph_cleaner），在模块的.module文件中添加以下代码：

/**
 * Implements hook_entity_delete().
 */
function my_paragraph_cleaner_entity_delete(Drupal\Core\Entity\EntityInterface $entity) {
  // 当节点被删除时，删除其关联的所有Paragraph
  if ($entity->getEntityTypeId() === 'node') {
    $paragraph_storage = \Drupal::entityTypeManager()->getStorage('paragraph');
    $paragraphs = $paragraph_storage->loadByProperties([
      'parent_id' => $entity->id(),
      'parent_type' => 'node',
    ]);
    foreach ($paragraphs as $paragraph) {
      $paragraph->delete();
    }
  }
}

/**
 * Implements hook_entity_update().
 */
function my_paragraph_cleaner_entity_update(Drupal\Core\Entity\EntityInterface $entity) {
  // 仅处理节点更新场景
  if ($entity->getEntityTypeId() !== 'node') {
    return;
  }

  // 获取当前节点关联的所有Paragraph ID
  $current_ids = [];
  foreach ($entity->getFields() as $field) {
    if ($field->getFieldDefinition()->getType() === 'entity_reference_revisions') {
      foreach ($field->getValue() as $item) {
        $current_ids[] = $item['target_id'];
      }
    }
  }

  // 获取节点更新前关联的Paragraph ID
  $original_ids = [];
  foreach ($entity->original->getFields() as $field) {
    if ($field->getFieldDefinition()->getType() === 'entity_reference_revisions') {
      foreach ($field->getValue() as $item) {
        $original_ids[] = $item['target_id'];
      }
    }
  }

  // 找出被移除的Paragraph ID
  $removed_ids = array_diff($original_ids, $current_ids);
  if (empty($removed_ids)) {
    return;
  }

  $paragraph_storage = \Drupal::entityTypeManager()->getStorage('paragraph');
  $paragraphs = $paragraph_storage->loadMultiple($removed_ids);

  foreach ($paragraphs as $paragraph) {
    // 确认该Paragraph没有其他父实体（避免误删被复用的Paragraph）
    $has_other_parent = \Drupal::entityQuery('paragraph')
      ->condition('id', $paragraph->id())
      ->exists('parent_id')
      ->count()
      ->execute();

    if (!$has_other_parent) {
      $paragraph->delete();
    }
  }
}

这段代码的作用：

• 当节点被删除时，自动删除所有关联的Paragraph
• 当节点更新（移除Paragraph）时，检查被移除的Paragraph是否还有其他父关联，没有则自动删除

三、关键注意事项 #

• 备份优先：无论用哪种方法清理数据，操作前一定要完整备份数据库，防止误删重要数据
• 复用场景排查：如果你的系统中有Paragraph被多个节点复用的情况，一定要确保清理逻辑不会误删这些被复用的实体
• 测试环境验证：自定义代码或批量操作先在测试环境验证，确认没问题再部署到生产环境

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