Yii2用户权限更新问题：重复权限组合保存报错

你遇到的错误是因为AuthAssignment表的item_name和user_id是联合唯一约束，而你的代码在更新权限时没有处理用户已有的权限记录，直接尝试插入新的记录，导致重复违反约束。

问题根源分析 #

当前代码的逻辑存在明显漏洞：

• 加载用户提交的权限列表后，直接循环创建新的AuthAssignment实例并保存
• 完全忽略了用户可能已经拥有其中某些权限的情况，重复插入就触发了数据库的唯一约束报错

最优解决方案：使用Yii2内置的RBAC组件处理 #

Yii2的AuthManager组件已经封装了权限分配、移除的方法，完全可以避免手动操作AuthAssignment表的问题，同时更符合RBAC的设计规范。

修改后的actionUpdate代码如下：

public function actionUpdate($id) {
    $model = $this->findModel($id);
    $auth = Yii::$app->authManager;
    
    // 预加载用户当前的权限，用于表单回显
    $currentAssignments = $auth->getAssignments($id);
    $model->perfil_array = array_keys($currentAssignments);

    if ($model->load(Yii::$app->request->post()) && $model->validate()) {
        // 获取提交的新权限列表，为空则设为空数组
        $newPermissions = Yii::$app->request->post()['User']['perfil_array'] ?? [];

        // 第一步：移除用户不再拥有的权限
        foreach ($currentAssignments as $assignment) {
            if (!in_array($assignment->itemName, $newPermissions)) {
                $auth->revoke($assignment->item, $id);
            }
        }

        // 第二步：添加用户新选择的权限
        foreach ($newPermissions as $permissionName) {
            // 检查权限/角色是否存在（兼容角色和权限两种类型）
            $item = $auth->getRole($permissionName) ?? $auth->getPermission($permissionName);
            if ($item && !$auth->checkAccess($id, $permissionName)) {
                $auth->assign($item, $id);
            }
        }

        // 保存用户基础信息
        if ($model->save()) {
            return $this->redirect(['view', 'id' => $model->id]);
        } else {
            print_r($model->getErrors());
            return $this->render('update', [
                'model' => $model,
            ]);
        }
    }

    return $this->render('update', ['model' => $model]);
}

代码说明： #

1. 预加载权限：使用AuthManager的getAssignments方法获取用户当前的权限，赋值给perfil_array用于表单回显，替代原来手动遍历authAssignment关联的逻辑，更简洁可靠。
2. 权限同步：
   • 先移除用户不再拥有的权限：对比当前权限和提交的新权限，把不在新列表里的权限移除
   • 再添加新权限：检查每个提交的权限是否存在，并且用户尚未拥有，才执行分配操作，从根源避免重复插入
3. 兼容性：同时支持角色（Role）和权限（Permission）的分配，因为getRole和getPermission会分别查找对应的RBAC项。

简化版方案（适合简单场景） #

如果你的场景不需要保留原有权限的增量更新，也可以直接先清空用户所有权限，再批量添加新权限，代码更易维护：

// 替换权限处理部分的代码
$newPermissions = Yii::$app->request->post()['User']['perfil_array'] ?? [];
// 清空用户所有已有权限
$auth->revokeAll($id);
// 批量添加新权限
foreach ($newPermissions as $permissionName) {
    $item = $auth->getRole($permissionName) ?? $auth->getPermission($permissionName);
    if ($item) {
        $auth->assign($item, $id);
    }
}

这种方式适合权限列表比较短，或者不需要关注增量更新的场景，代码逻辑更简单直接。

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