Doctrine detach方法引发关联实体持久化异常问题咨询

我搞不懂Doctrine的detach()方法到底怎么工作的，以下是我的使用场景：

实体定义 #

Users实体 #

/**
 * @ORM\Entity(repositoryClass="UsersRepository")
 * @ORM\Table(name="users")
 */
class Users
{
    // ....
    
    /**
     * @ORM\ManyToOne(targetEntity="\App\Entity\ParentType")
     * @ORM\JoinColumn(name="ID_PARENT_TYPE", referencedColumnName="ID_PARENT_TYPE")
     *
    private ParentType $parentType;
}

CustomInfo实体 #

/**
 * @ORM\Entity(repositoryClass="CustomInfoRepository")
 * @ORM\Table(name="custom_info")
 */
class CustomInfo
{
    // ....

    /**
     * @ORM\ManyToOne(targetEntity="\App\Entity\Users")
     * @ORM\JoinColumn(name="ID_USER", referencedColumnName="ID_USER")
     *
     */
    private Users $user;
    
    /**
     * @ORM\ManyToOne(targetEntity="\App\Entity\ParentType")
     * @ORM\JoinColumn(name="ID_PARENT_TYPE", referencedColumnName="ID_PARENT_TYPE")
     *
    private ParentType $parentType;
}

仓库方法 #

UsersRepository #

public function detach(object $entity) {
    $this->_em->detach($entity);
}

CustomInfoRepository #

public function save(CustomInfo $customInfo, bool $isUpdate = false)
{
    if($isUpdate === false) {
        $this->_em->persist($monthlyBalance); // 注意：此处变量名应为$customInfo，属于笔误
    }
    $this->_em->flush();
}

业务逻辑代码 #

// $users = $this->createQueryBuilder('q')->getQuery()

foreach ($users->toIterable() as $user) {
  // 获取对应的CustomInfo对象
  $customInfo = $customInfoRepository->getCustomInfo($user->getId());
  // 更新$customInfo的一些字段...
  $customInfoRepository->save($customInfo);

  // 尝试detach $user来节省内存
  $this->usersRepository->detach($user);
}

首次迭代保存正常，但第二次迭代时抛出ORMInvalidArgumentException异常（位于ORMInvalidArgumentException.php第102行），提示信息：“通过关联关系‘App\Entity\CustomInfo#user’发现新实体App\Entity\Users，未配置级联持久化操作”。

请问为什么detach()会影响$users集合里的其他实体？

问题根源 #

1. Doctrine标识映射的特性：EntityManager会维护一个标识映射（Identity Map），数据库中同一行数据对应的实体在内存中只会有一个实例。第一次迭代获取的$user会被存入这个映射，调用detach($user)后，该实例被移出映射，不再被EntityManager管理。
2. 关联实体的状态冲突：第二次迭代加载新用户时，之前获取的CustomInfo对象关联的$user实例已经处于“未被管理”状态。flush操作时，EntityManager检查CustomInfo#user关联，发现这个用户实例不在自己的管理范围内，就会误判为“新实体”，要求配置级联持久化——但实际上该用户本来就存在于数据库中。
3. 代码笔误：CustomInfoRepository::save方法里的$monthlyBalance是错误变量名，应该改为$customInfo，虽不是当前异常的直接原因，但必须修正。

解决办法 #

方案1：用批量clear替代单个detach（推荐，解决内存问题的同时避免异常）

如果是为了节省内存，不要逐个detach实体，而是每处理一定数量的用户后，调用clear()清空整个EntityManager的管理实体（确保flush已完成）：

$batchSize = 20;
$count = 0;

foreach ($users->toIterable() as $user) {
  $customInfo = $customInfoRepository->getCustomInfo($user->getId());
  // 更新字段...
  $customInfoRepository->save($customInfo);

  $count++;
  if ($count % $batchSize === 0) {
      $this->_em->clear(); // 清空管理实体，释放内存
  }
}
// 处理剩余未清理的实体
$this->_em->clear();

方案2：调整CustomInfo的关联配置（仅规避异常，不推荐随意使用）

在CustomInfo#user的关联注解中添加cascade={"refresh"}，让EntityManager自动刷新关联的用户实体状态，避免误判：

/**
 * @ORM\ManyToOne(targetEntity="\App\Entity\Users", cascade={"refresh"})
 * @ORM\JoinColumn(name="ID_USER", referencedColumnName="ID_USER")
 */
private Users $user;

方案3：避免自动加载关联的用户实体

修改getCustomInfo方法，使用QueryBuilder时不主动关联Users实体（ManyToOne默认是延迟加载，只要不主动join就不会立即加载），这样CustomInfo中的$user不会被实例化，也就不会出现状态冲突：

// CustomInfoRepository
public function getCustomInfo(int $userId)
{
    return $this->createQueryBuilder('ci')
        ->where('ci.user = :userId')
        ->setParameter('userId', $userId)
        ->getQuery()
        ->getOneOrNullResult();
    // 不要join Users，保持关联的延迟加载状态
}

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