Symfony 6 + API Platform：创建新实体时恢复已软删除用户

一、先解决数据库唯一约束冲突问题 #

你的方案2触发唯一约束错误，核心原因是现有唯一约束没有区分软删除状态——软删除的用户依然占用着邮箱的唯一索引，导致新用户插入时冲突。

需要给邮箱字段创建部分唯一索引，仅对未软删除的用户生效：

PostgreSQL：

CREATE UNIQUE INDEX idx_user_email_active ON "user" (email) WHERE deleted_at IS NULL;

MySQL：

CREATE UNIQUE INDEX idx_user_email_active ON `user` (email) WHERE deleted_at IS NULL;

这个索引会忽略已软删除（deleted_at不为空）的用户，既保证正常用户邮箱唯一，又不会阻止恢复软删除用户的操作。

二、替换API Platform的POST处理逻辑（推荐方案） #

API Platform的POST请求默认绑定"创建实体"逻辑，你之前尝试的反序列化挂钩、Doctrine prePersist事件都属于流程后期介入，容易和框架默认逻辑冲突。更合适的方式是用自定义数据处理器接管POST注册请求：

1. 创建自定义数据处理器

// src/DataProcessor/UserDataProcessor.php
namespace App\DataProcessor;

use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProcessorInterface;
use App\Entity\User;
use App\Repository\UserRepository;
use Doctrine\ORM\EntityManagerInterface;

class UserDataProcessor implements ProcessorInterface
{
    public function __construct(
        private readonly ProcessorInterface $decorated,
        private readonly UserRepository $userRepository,
        private readonly EntityManagerInterface $em
    ) {}

    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = [])
    {
        // 仅处理User实体的POST注册请求
        if (!$data instanceof User || $operation->getName() !== 'post') {
            return $this->decorated->process($data, $operation, $uriVariables, $context);
        }

        // 查找已软删除的同邮箱用户
        $deletedUser = $this->userRepository->findOneBy([
            'email' => $data->getEmail(),
            'deletedAt' => ['NOT', null]
        ]);

        if ($deletedUser) {
            // 恢复用户：清除软删除标记，同步新注册的字段（如密码、用户名）
            $deletedUser->setDeletedAt(null);
            $deletedUser->setPassword($data->getPassword());
            $deletedUser->setUsername($data->getUsername());
            // 按需同步其他注册字段...

            $this->em->flush();
            return $deletedUser;
        }

        // 无软删除用户，执行正常创建流程
        return $this->decorated->process($data, $operation, $uriVariables, $context);
    }
}

2. 配置服务装饰默认处理器

在config/services.yaml中注册处理器，让它接管API Platform的默认持久化逻辑：

services:
    App\DataProcessor\UserDataProcessor:
        decorates: 'api_platform.doctrine.orm.state.persist_processor'
        arguments:
            $decorated: '@.inner'

三、为什么之前的方案2失败？ #

Doctrine的prePersist事件触发时，框架已经完成了新实体的持久化准备，即使你detach了新实体，Doctrine仍可能残留插入操作的队列。加上数据库层面的唯一约束未区分软删除，最终导致冲突报错。而自定义数据处理器是在API Platform请求流程的早期介入，直接替换"创建"逻辑为"恢复"逻辑，完全符合框架的执行流程。

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