如何让EntityManager的flush仅刷新特定实体实例？

问题核心 #

EntityManager的flush()默认会提交所有已缓冲的实体变更，导致跨服务调用时，某层服务的flush操作会意外提交其他层未完成的变更，破坏业务逻辑的原子性。

解决方案 #

1. 细粒度控制flush的实体

Doctrine的EntityManager支持在flush()时传入单个/多个实体，仅提交指定实体的变更，而非全部缓冲操作。

修改Repository的add方法，将全局flush改为仅刷新当前实体：

public function add(Visit $entity, bool $flush = false): void
{
    $this->getEntityManager()->persist($entity);

    if ($flush) {
        $this->getEntityManager()->flush($entity); // 仅提交当前实体的变更
    }
}

这样ServiceA中调用add($user, true)时，只会提交User实体的变更，不会触发ServiceB中未完成的Visit变更提交。

2. 重构服务职责，统一控制提交时机

将flush的控制权从底层服务上移到顶层调用者，避免底层服务隐式提交变更：

• 所有Repository的add方法默认关闭自动flush
• 顶层服务统一管理所有变更的提交顺序

修改ServiceA的foo方法：

class ServiceA{
   public function __construct(private UserRepository $userRepository){}
   
   public function foo(){
      $user = $this->userRepository->find(1);
      $user->setName('newName');
      $this->userRepository->add($user); // 不自动flush
   }
}

修改ServiceB的bar方法，统一控制提交：

public function bar(){
    $visit = $this->visitRepository->find(2);
    $visit->setSomething(2);
    $this->visitRepository->add($visit);
    
    // 其他未flush的Visit操作...
    
    $this->serviceA->foo();

    // 按业务需求顺序提交变更
    $this->userRepository->flush();
    $this->visitRepository->flush();
}

3. 使用非共享EntityManager隔离上下文

如果需要完全独立的变更上下文，可以配置非共享的EntityManager服务，每个服务实例拥有独立的实体缓存和变更队列。

以Symfony为例，在services.yaml中配置非共享服务：

services:
    App\Service\ServiceA:
        arguments:
            $userRepository: '@App\Repository\UserRepository'
        shared: false # 每次注入新实例，对应独立EntityManager

这样ServiceA的EntityManager与ServiceB的完全隔离，各自的flush操作只会提交自身上下文的变更。

方案优先级 #

优先选择细粒度flush实体（侵入性最小，无需重构服务），其次是统一控制提交时机（符合DDD领域职责设计），最后考虑非共享EntityManager（适合完全独立的业务流程，注意资源消耗）。

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