如何让Doctrine在更新Order时不持久化关联关系

问题根源 #

你遇到的异常是因为删除AssignedOrderItem后，Order的assignedItems集合中仍保留着该实体的引用，Doctrine在跟踪Order状态时，误将已删除的实体判定为未被管理的新实体，从而触发持久化检查。

解决方案 #

1. 维护双向关联的一致性（推荐）

在删除AssignedOrderItem时，必须同步维护双向关联的两边状态，避免集合中残留无效引用：

$existingItem = $this->em->find(AssignedOrderItem::class, $removeId);
// 获取关联的订单
$order = $existingItem->getOrder();
// 从订单集合中移除该实体
$order->getAssignedItems()->removeElement($existingItem);
// 解除实体与订单的关联
$existingItem->setOrder(null);

$this->em->remove($existingItem);
$this->em->flush();

这样后续更新Order时，集合中已无无效引用，不会触发异常。

2. 临时清除关联字段的变更跟踪

如果只是临时需要忽略assignedItems的检查，可在更新Order前清除该字段的变更记录：

$order->setPrice(1234, 'USD');
// 让Doctrine忽略assignedItems字段的状态变更
$this->em->getUnitOfWork()->clearEntityChangeSet($order, 'assignedItems');

$this->em->persist($order);
$this->em->flush();

3. 配置关联为只读（永久忽略）

若你完全不需要通过Order实体维护assignedItems关联，可在映射中设置该关联为只读：

// Order实体中的关联注解示例
/**
 * @OneToMany(
 *     targetEntity=AssignedOrderItem::class,
 *     mappedBy="order",
 *     readOnly=true
 * )
 */
private $assignedItems;

配置后，Doctrine在持久化Order时会自动忽略该关联的所有变更。

4. 使用DQL执行部分更新（绕过实体跟踪）

如果仅需更新Order的个别字段，可直接用DQL执行更新操作，完全绕过Doctrine的实体关联检查：

$this->em->createQueryBuilder()
    ->update(Order::class, 'o')
    ->set('o.price', ':price')
    ->set('o.currency', ':currency')
    ->where('o.id = :id')
    ->setParameters([
        'price' => 1234,
        'currency' => 'USD',
        'id' => $order->getId()
    ])
    ->getQuery()
    ->execute();

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