Drupal 9 技术问询：如何通过代码为已有字段添加新分类术语

你的代码存在几个关键问题，导致术语引用字段无法正常更新，以下是修复方案和解析：

问题点分析 #

• 术语ID类型不匹配：你定义的$new_category是字符串类型"100647"，但Drupal的术语引用字段target_id要求是整数类型，类型不匹配可能导致字段值无法正确保存。
• 字段值构造不规范：虽然Drupal部分场景下支持直接传入ID数组，但更严谨的方式是按照字段的结构要求构造数据，避免潜在的类型转换问题。
• 空异常捕获：你的catch块没有任何错误输出，即使保存过程中抛出异常也无法排查问题，这会掩盖真实的错误原因。
• 冗余的数组重构：可以直接使用字段的getValue()获取现有值，无需循环提取target_id，后续添加新项时可直接追加正确结构的数据。

修复后的代码 #

$nids = [123, 124, 125];
$new_category_tid = 100647; // 改为整数类型

foreach ($nids as $nid) {
  /** @var \Drupal\node\NodeInterface $node */
  $node = \Drupal::entityTypeManager()->getStorage('node')->load($nid);
  $existing_terms = $node->get('field_category')->getValue();
  
  // 检查新术语是否已存在
  $term_exists = false;
  foreach ($existing_terms as $term) {
    if ((int)$term['target_id'] === $new_category_tid) {
      $term_exists = true;
      break;
    }
  }

  if (!$term_exists) {
    // 追加新术语的正确结构
    $existing_terms[] = ['target_id' => $new_category_tid];
    
    try {
      $node->set('field_category', $existing_terms);
      $node->save();
    } catch (\Exception $e) {
      // 输出错误信息用于排查
      \Drupal::logger('custom_node_update')->error('更新节点@nid时出错: @message', [
        '@nid' => $nid,
        '@message' => $e->getMessage(),
      ]);
    }
  }
}

更简洁的写法（使用字段的addItem方法） #

Drupal的实体引用字段提供了addItem()方法，可以直接添加新术语，无需手动重构数组，代码更简洁：

$nids = [123, 124, 125];
$new_category_tid = 100647;

foreach ($nids as $nid) {
  /** @var \Drupal\node\NodeInterface $node */
  $node = \Drupal::entityTypeManager()->getStorage('node')->load($nid);
  $field_category = $node->get('field_category');
  
  // 检查术语是否已存在
  $term_exists = false;
  foreach ($field_category as $item) {
    if ($item->target_id == $new_category_tid) {
      $term_exists = true;
      break;
    }
  }

  if (!$term_exists) {
    try {
      $field_category->addItem(['target_id' => $new_category_tid]);
      $node->save();
    } catch (\Exception $e) {
      \Drupal::logger('custom_node_update')->error('节点@nid更新失败: @msg', [
        '@nid' => $nid,
        '@msg' => $e->getMessage(),
      ]);
    }
  }
}

额外检查项 #

• 确认术语ID100647对应的分类术语确实存在，且该术语的词汇表与field_category字段配置的目标词汇表一致。
• 检查当前执行代码的用户是否有修改该节点类型和术语引用字段的权限，权限不足也会导致保存失败。

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