Drupal 8迁移时如何关联subgroup与group？process plugin开发求助

我之前帮朋友处理过类似的Drupal Group迁移适配问题，刚好可以给你一个实用的解决方案，帮你搞定子组关联父组的迁移问题：

从旧版Group RC5+Subgroup补丁迁移到官方稳定版Subgroup模块时，核心差异在于父组与子组的关联逻辑从补丁的自定义字段变成了模块原生的实体引用关系，所以直接沿用旧SQL脚本会失效，维护者建议的Process Plugin是最规范的解决方案。

1. 创建插件文件 #

在你的自定义迁移模块（比如custom_migrate）下创建以下目录结构和文件：
src/Plugin/migrate/process/SubgroupParentLink.php

2. 插件代码示例 #

<?php

namespace Drupal\custom_migrate\Plugin\migrate\process;

use Drupal\migrate\ProcessPluginBase;
use Drupal\migrate\MigrateExecutableInterface;
use Drupal\migrate\Row;

/**
 * 迁移时将子组关联到对应的父组
 *
 * @MigrateProcessPlugin(
 *   id = "subgroup_parent_link"
 * )
 */
class SubgroupParentLink extends ProcessPluginBase {

  /**
   * {@inheritdoc}
   */
  public function transform($value, MigrateExecutableInterface $migrate_executable, Row $row, $destination_property) {
    // $value 是源数据库中父组的原始ID
    $source_parent_id = $value;

    // 从父组迁移的映射表中查找新系统的父组ID
    // 替换成你的父组迁移机器名（比如'migrate_groups_parent'）
    $parent_migration = $migrate_executable->getMigration()->getDependencyMigration('migrate_groups_parent');
    if ($parent_migration) {
      $map = $parent_migration->getIdMap();
      $dest_parent_id = $map->lookupDestinationID(['gid' => $source_parent_id]);

      if (!empty($dest_parent_id)) {
        // 返回Subgroup模块要求的父组引用结构（默认是target_id格式）
        return ['target_id' => reset($dest_parent_id)];
      }
    }

    // 找不到对应父组时返回空，或根据需求抛出警告
    \Drupal::logger('custom_migrate')->warning('找不到父组ID: @source_id', ['@source_id' => $source_parent_id]);
    return NULL;
  }

}

3. 在迁移配置中使用插件 #

在你的子组迁移YAML文件（比如migrate_subgroups.yml）的process部分，添加父组关联的处理逻辑：

# 假设子组类型中父组引用字段名为'parent_group'
parent_group:
  plugin: subgroup_parent_link
  source: parent_gid # 源数据库中存储父组ID的字段名

• 迁移顺序依赖：必须确保父组迁移在子组迁移之前执行，在子组迁移配置中添加依赖：

  migration_dependencies:
    required:
      - migrate_groups_parent
  

• 字段名验证：先在新系统后台查看子组类型的父组引用字段名称（路径：结构 → 组类型 → 子组类型 → 管理字段），确保插件返回的结构匹配字段要求
• 映射表调试：如果出现关联失败，可以用drush migrate:map-status migrate_groups_parent查看父组迁移的映射关系是否正确
• 权限测试：迁移完成后，务必测试父组角色到子组角色的权限继承（比如父组manager是否自动拥有子组manager权限），避免Subgroup树配置未生效
• 日志调试：可以在插件中添加更多日志输出，用drush watchdog:show --type=custom_migrate查看迁移过程中的错误信息

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