ApiPlatform：如何更新非ApiResource/ApiSubresource的子实体

我来帮你搞定这个问题！你遇到的情况是ApiPlatform在处理未标记为@ApiResource的关联实体时，反序列化阶段会创建新对象，再加上Doctrine级联持久化的设置，就导致了新建而非更新的问题。下面给你几个可行的解决方案：

方法1：自定义数据处理器（推荐，无需修改第三方代码） #

这个方法通过装饰ApiPlatform的默认数据处理器，在持久化前手动加载现有第三方实体并合并属性。

步骤1：创建数据处理器类 #

<?php

namespace App\DataProcessor;

use ApiPlatform\Core\DataPersister\ContextAwareDataPersisterInterface;
use App\Entity\MyEntity;
use Namespace\To\Bundle\Entity\ThirdPartyEntity;
use Doctrine\ORM\EntityManagerInterface;

class MyEntityDataProcessor
{
    private $decoratedPersister;
    private $entityManager;

    public function __construct(ContextAwareDataPersisterInterface $decoratedPersister, EntityManagerInterface $entityManager)
    {
        $this->decoratedPersister = $decoratedPersister;
        $this->entityManager = $entityManager;
    }

    public function supports($data, string $resourceClass, string $operationName = null, array $context = []): bool
    {
        // 只处理MyEntity的PUT请求
        return $data instanceof MyEntity && $operationName === 'put';
    }

    public function process($data, string $resourceClass, string $operationName = null, array $context = [])
    {
        $thirdPartyEntity = $data->getThirdPartyEntity();
        
        // 如果第三方实体有ID，尝试从数据库加载现有实例
        if ($thirdPartyEntity && $thirdPartyEntity->getId()) {
            $existingEntity = $this->entityManager
                ->getRepository(ThirdPartyEntity::class)
                ->find($thirdPartyEntity->getId());
                
            if ($existingEntity) {
                // 把请求中的属性合并到现有实体
                $existingEntity->setAProperty($thirdPartyEntity->getAProperty());
                // 替换为现有实体，避免新建
                $data->setThirdPartyEntity($existingEntity);
            }
        }

        // 交给原处理器完成持久化
        return $this->decoratedPersister->process($data, $resourceClass, $operationName, $context);
    }
}

步骤2：配置服务装饰 #

在config/services.yaml里添加配置，让我们的处理器装饰默认的Doctrine数据持久化器：

services:
    App\DataProcessor\MyEntityDataProcessor:
        decorates: api_platform.doctrine.orm.data_persister
        arguments:
            $decoratedPersister: '@App\DataProcessor\MyEntityDataProcessor.inner'
            $entityManager: '@doctrine.orm.default_entity_manager'

方法2：调整Doctrine关联的级联设置（简单但有局限性） #

如果你能修改trait的代码，可以把级联操作从{"all"}改成{"merge", "remove"}，去掉persist：

/**
 * @ORM\OneToOne(targetEntity="Namespace\To\Bundle\Entity\ThirdPartyEntity", cascade={"merge", "remove"})
 * @ORM\JoinColumn(name="thirdPartyEntity", referencedColumnName="id")
 */
private $thirdPartyEntity;

这样Doctrine不会自动持久化新创建的ThirdPartyEntity对象，但前提是这个实体已经存在于数据库中，否则会抛出关联不存在的错误。

方法3：使用DTO（数据传输对象） #

通过DTO来接收PUT请求的数据，再手动映射到实体，这种方式更灵活，适合复杂场景。

步骤1：创建PUT请求的DTO #

<?php

namespace App\Dto;

use ApiPlatform\Core\Annotation\ApiResource;
use Namespace\To\Bundle\Entity\ThirdPartyEntity;

/**
 * @ApiResource(
 *     itemOperations={
 *         "put"={
 *             "input"=MyEntityPutDto::class,
 *             "output"=MyEntity::class
 *         }
 *     }
 * )
 */
class MyEntityPutDto
{
    public int $id;
    public ?ThirdPartyEntity $thirdPartyEntity;
    // 添加MyEntity需要修改的其他属性
}

步骤2：创建数据转换器 #

<?php

namespace App\DataTransformer;

use ApiPlatform\Core\DataTransformer\DataTransformerInterface;
use App\Dto\MyEntityPutDto;
use App\Entity\MyEntity;
use Namespace\To\Bundle\Entity\ThirdPartyEntity;
use Doctrine\ORM\EntityManagerInterface;

class MyEntityPutTransformer implements DataTransformerInterface
{
    private $entityManager;

    public function __construct(EntityManagerInterface $entityManager)
    {
        $this->entityManager = $entityManager;
    }

    public function transform($object, string $to, array $context = [])
    {
        // 加载现有MyEntity实例
        $myEntity = $this->entityManager->getRepository(MyEntity::class)->find($object->id);
        
        // 处理第三方实体
        if ($object->thirdPartyEntity && $object->thirdPartyEntity->getId()) {
            $existingThirdParty = $this->entityManager
                ->getRepository(ThirdPartyEntity::class)
                ->find($object->thirdPartyEntity->getId());
                
            if ($existingThirdParty) {
                $existingThirdParty->setAProperty($object->thirdPartyEntity->getAProperty());
                $myEntity->setThirdPartyEntity($existingThirdParty);
            }
        }

        // 映射其他属性到MyEntity
        // ...

        return $myEntity;
    }

    public function supportsTransformation($data, string $to, array $context = []): bool
    {
        return $to === MyEntity::class && $data instanceof MyEntityPutDto;
    }
}

为什么会出现这个问题？ #

核心原因有两个：

1. ApiPlatform反序列化逻辑：对于未标记@ApiResource的实体，ApiPlatform不会尝试从数据库加载现有实例，而是直接创建新对象，哪怕请求里传了id。
2. Doctrine级联设置：cascade={"all"}包含了persist操作，Doctrine会把这个新创建的对象当作需要持久化的实体，从而生成INSERT语句而非UPDATE。

以上几种方法都能解决这个问题，推荐优先用方法1，不需要修改第三方代码也能灵活处理。

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