Drupal user_save()函数无法更新用户：创建新用户或抛出重复键异常

嘿，我碰到过不少类似的情况，你遇到的这两个问题本质上是同一个根源：Drupal没法识别你要更新的是已存在的用户对象，所以默认走了创建新用户的逻辑，才会要么生成新用户，要么因为用户名重复抛出SQL错误。

先拆解下问题原因：

• 当user_save()接收到的用户对象缺少有效的uid字段，或者uid被意外重置为0时，Drupal就会判定这是一个新用户，尝试插入而非更新记录。
• 你遇到的重复键错误，就是因为系统误以为要创建新用户，但这个“新用户”的用户名（name字段）和现有用户重复，触发了数据库唯一键约束。

结合你的代码，给你几个针对性的解决方案：

1. 确保用户对象正确加载且标识完整 #

首先要确认user_load()确实返回了有效的用户对象，避免后续操作基于空对象或者错误对象执行：

// 加载用户对象，先做有效性检查
$account = user_load($user->uid);
if (!$account || empty($account->uid)) {
  drupal_set_message('用户加载失败或用户ID无效', 'error');
  // 这里可以根据业务逻辑做跳转或终止操作
  return;
}

2. 用正确的方式调用user_save()（针对Drupal 7） #

Drupal 7的user_save()并不推荐直接修改用户对象后调用，标准用法是构造一个更新数组$edit，再传入要更新的用户对象：

// 加载用户对象并校验
$account = user_load($user->uid);
if (!$account || empty($account->uid)) {
  drupal_set_message('用户加载失败或用户ID无效', 'error');
  return;
}

// 处理要更新的字段
$termIds = []; // 假设这是你要合并的term数组
$saved = $account->selected_keyword;
if (isset($saved)) {
  array_push($termIds, $saved);
}

// 构造更新数组
$edit = [
  'selected_keyword' => $termIds,
];

// 执行保存操作
user_save($account, $edit);

这种方式能明确告诉Drupal：你要更新的是$account对应的现有用户，而不是创建新用户。

3. 排查模块或字段干扰 #

如果还是出现问题，可能是其他模块在篡改用户对象：

• 临时禁用非核心模块，测试是否还会出现错误，逐步排查是哪个模块导致的用户对象异常。
• 检查selected_keyword这个自定义字段的配置，确保字段存储逻辑正常，不会意外清空用户对象的核心字段（比如uid、name）。

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