API Platform中Doctrine继承下OneToMany关联无法持久化问题

以下是针对该问题的具体排查与解决步骤：

1. 校验关联注解与双向关联维护 #

• 确保父类（如User）的OneToMany注解配置cascade={"persist"}，否则Doctrine不会自动持久化关联的Metadata实体：

  // User.php
  /**
   * @ORM\OneToMany(targetEntity=Metadata::class, mappedBy="user", cascade={"persist", "remove"})
   */
  private $metadata;
  

• 确认Metadata实体的ManyToOne注解正确关联父类，且inversedBy指向对应字段：

  // Metadata.php
  /**
   * @ORM\ManyToOne(targetEntity=User::class, inversedBy="metadata")
   * @ORM\JoinColumn(nullable=false)
   */
  private $user;
  

• 必须维护双向关联关系：在User实体中添加addMetadata和removeMetadata方法（API Platform优先调用这类方法而非直接设置数组）：

  // User.php
  public function addMetadata(Metadata $metadata): self
  {
      if (!$this->metadata->contains($metadata)) {
          $this->metadata[] = $metadata;
          $metadata->setUser($this);
      }
      return $this;
  }
  
  public function removeMetadata(Metadata $metadata): self
  {
      if ($this->metadata->removeElement($metadata)) {
          if ($metadata->getUser() === $this) {
              $metadata->setUser(null);
          }
      }
      return $this;
  }
  

2. 配置API Platform支持关联反序列化 #

• 在Dummy（或User）实体的metadata字段上添加API Platform属性配置，明确支持嵌入关联资源：

  /**
   * @ORM\OneToMany(...)
   * @ApiProperty(attributes={
   *     "openapi_context"={
   *         "type"="array",
   *         "items"={"$ref"="#/components/schemas/Metadata"}
   *     }
   * })
   */
  private $metadata;
  

• 在@ApiResource注解中开启深度反序列化支持（若存在多层嵌套）：

  /**
   * @ApiResource(
   *     denormalizationContext={"enable_max_depth"=true}
   * )
   */
  class Dummy extends User
  {
      // ...
  }
  

• 确保提交的JSON数据结构正确，示例：

  {
    "username": "test_dummy",
    "metadata": [
      {"key": "theme", "value": "dark"},
      {"key": "lang", "value": "zh-CN"}
    ]
  }
  

3. 验证Doctrine JOINED继承映射 #

• 确认父类User的继承配置正确：

  /**
   * @ORM\Entity
   * @ORM\InheritanceType("JOINED")
   * @ORM\DiscriminatorColumn(name="discr", type="string")
   * @ORM\DiscriminatorMap({"user" = User::class, "dummy" = Dummy::class})
   */
  class User
  {
      // ...
  }
  

• 子类Dummy只需标注@ORM\Entity即可，无需重复继承配置：

  /**
   * @ORM\Entity
   */
  class Dummy extends User
  {
      // ...
  }
  

• 运行Doctrine schema验证命令排查映射错误：

  php bin/console doctrine:schema:validate
  

4. 调试持久化过程 #

• 开启Doctrine SQL日志，查看是否生成Metadata的插入语句：
  在config/packages/doctrine.yaml中开启日志：

  doctrine:
      dbal:
          # ...
          logging: true
      orm:
          # ...
          auto_generate_proxy_classes: true
          logging: true
  

• 执行curl请求后，查看var/log/dev.log中的SQL语句，确认是否存在INSERT INTO metadata (...)的记录。

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