Symfony4 + FOSRestBundle + Doctrine2：实体新增/更新问题求助

嘿，别紧张，第一次提问完全没问题，咱们一起把这个问题捋清楚！结合你提到的Symfony4 + FOSRestBundle + Doctrine2 + JMSSerializer技术栈，我猜你大概率是想在创建Client的同时，要么关联数据库中已有的Culture/Extra实体，要么直接创建并关联全新的Culture/Extra——下面分这两种最常见的场景给你解决方案：

1. 关联已存在的实体（通过ID或API路径） #

如果你的请求JSON是直接传关联实体的ID或者API资源路径，比如：

{
  "name": "测试客户",
  "culture": 1,
  "extras": [2, 3]
}

配置JMSSerializer反序列化 #

在Client实体的关联字段上添加序列化注解，指定反序列化的目标实体类型：

use JMS\Serializer\Annotation as Serializer;
use Doctrine\ORM\Mapping as ORM;
use Doctrine\Common\Collections\ArrayCollection;

/**
 * @ORM\Entity()
 */
class Client
{
    // ...其他基础字段

    /**
     * @ORM\ManyToOne(targetEntity="App\Entity\Culture")
     * @Serializer\Type("App\Entity\Culture")
     * @Serializer\SerializedName("culture")
     */
    private $culture;

    /**
     * @ORM\ManyToMany(targetEntity="App\Entity\Extra")
     * @Serializer\Type("ArrayCollection<App\Entity\Extra>")
     * @Serializer\SerializedName("extras")
     */
    private $extras;

    // 构造函数初始化集合
    public function __construct()
    {
        $this->extras = new ArrayCollection();
    }
}

控制器中处理请求 #

借助FOSRestBundle的ParamConverter，可以自动把请求体反序列化为Client对象，直接持久化即可：

use FOS\RestBundle\Controller\AbstractFOSRestController;
use FOS\RestBundle\Controller\Annotations as Rest;
use Symfony\Component\HttpFoundation\Response;
use App\Entity\Client;

class ClientController extends AbstractFOSRestController
{
    /**
     * @Rest\Post("/api/clients")
     * @Rest\View(serializerGroups={"client"})
     */
    public function postClientAction(Client $client)
    {
        $em = $this->getDoctrine()->getManager();
        $em->persist($client);
        $em->flush();

        return $this->view($client, Response::HTTP_CREATED);
    }
}

ParamConverter会自动根据ID从数据库中取出对应的Culture/Extra实体，关联到Client上。

2. 创建并关联全新的Culture/Extra实体 #

如果你的请求JSON包含完整的关联实体数据，比如：

{
  "name": "测试客户",
  "culture": {
    "code": "zh_CN",
    "name": "中文"
  },
  "extras": [
    {
      "name": "会员特权",
      "price": 59.9
    },
    {
      "name": "免费售后",
      "price": 0
    }
  ]
}

配置Doctrine级联持久化 #

在Client实体的关联注解上添加cascade={"persist"}，这样持久化Client时会自动同步持久化关联的新实体：

/**
 * @ORM\ManyToOne(targetEntity="App\Entity\Culture", cascade={"persist"})
 * @Serializer\Type("App\Entity\Culture")
 */
private $culture;

/**
 * @ORM\ManyToMany(targetEntity="App\Entity\Extra", cascade={"persist"})
 * @ORM\JoinTable(name="client_extra")
 * @Serializer\Type("ArrayCollection<App\Entity\Extra>")
 */
private $extras;

补充集合操作方法 #

对于ManyToMany关联，一定要在Client实体中实现addExtra和removeExtra方法，JMSSerializer需要这些方法来填充集合：

public function addExtra(Extra $extra): self
{
    if (!$this->extras->contains($extra)) {
        $this->extras[] = $extra;
    }

    return $this;
}

public function removeExtra(Extra $extra): self
{
    $this->extras->removeElement($extra);

    return $this;
}

之后控制器的代码和第一种场景完全一样，直接持久化Client即可，Doctrine会自动把新的Culture/Extra也存入数据库。

3. 避坑提醒 #

• 确保所有实体的getter/setter都正确实现，尤其是关联字段的操作方法；
• 如果反序列化报错，优先检查JMSSerializer的Type注解是否写对了实体的完整命名空间；
• 可以通过序列化组（serializerGroups）控制返回的字段，避免循环引用问题。

如果你的具体需求和上面的场景有出入，比如需要部分更新关联实体，可以补充更多细节（比如完整的请求JSON、期望的数据库操作结果），我再帮你调整方案！

内容的提问来源于stack exchange，提问作者Jérémie S.