Symfony5.3 Doctrine持久化时找不到EnseigneNationale实体报错

运行自定义数据修正命令时Doctrine抛出如下异常：

Unable to find "Proxies_CG_\App\Entity\EnseigneNationale" entity identifier associated with the UnitOfWork

当前运行环境：PHP 7.4、Symfony 5.3、Doctrine 2.4。
涉及的Client实体关联映射定义：

/**
 * @ORM\ManyToOne(targetEntity="EnseigneNationale", inversedBy="clients")
 * ...
 */
private ?EnseigneNationale $enseigneNationale;

/**
 * @ORM\OneToMany(targetEntity="ClientBanque", mappedBy="client", cascade={"persist", "remove"})
 * ...
 */
private ?Collection $clientBanques;

数据修正命令核心处理逻辑：

if (Condition) {
        /** @var ClientBanque $clientBanque */
        $clientBanque = $clientBanques[0];
        $clientBanque->setAA($aa);
        $this->manager->persist($client);
    }

异常触发特征：执行persist操作时报错，EnseigneNationale字段本身配置为可为空，本次修改逻辑未操作该字段。

该异常和业务逻辑是否操作EnseigneNationale字段无直接关系，触发原因有两点：

• 旧库导入的数据存在脏值：部分Client记录的enseigne_nationale_id外键值在EnseigneNationale表中无对应记录。Doctrine加载这类Client实体时采用懒加载机制，不会立刻查询关联表，只会为enseigneNationale属性生成__CG__前缀的代理对象占位，该代理对象无有效主键，也未被UnitOfWork正确托管。
• 持久化逻辑冗余：$client是从数据库查询得到的已托管实体，修改关联的$clientBanque后不需要手动调用persist($client)，多余的persist操作会触发Doctrine对实体所有关联属性做全量状态校验，扫描到上述无效代理对象时就会抛出异常。

按优先级依次处理即可：

• 先清理源头脏数据
  执行SQL把Client表中无效的外键值置空，从根源解决无效关联问题：

  UPDATE client c 
  LEFT JOIN enseigne_nationale en ON c.enseigne_nationale_id = en.id 
  SET c.enseigne_nationale_id = NULL 
  WHERE en.id IS NULL;
  

• 修正命令中的持久化逻辑
  删掉多余的$this->manager->persist($client)调用，已托管的实体修改字段后直接调用flush()即可完成持久化，不需要重复persist。
  如果因为特殊逻辑必须保留persist操作，就在persist前增加代理对象校验，对无效关联直接置空：

  $enseigne = $client->getEnseigneNationale();
  if ($enseigne instanceof \Doctrine\ORM\Proxy\Proxy && !$enseigne->__isInitialized()) {
      try {
          $enseigne->__load();
      } catch (\Exception $e) {
          // 关联数据不存在，直接置空
          $client->setEnseigneNationale(null);
      }
  }
  

• 批量处理优化
  大批量修正数据时，每处理20~50条记录就执行一次flush()，随后调用$this->manager->clear()清理UnitOfWork缓存，避免代理对象残留、内存溢出问题。注意clear操作会把所有实体转为脱管状态，清理后需要重新从数据库拉取待处理的实体。

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