Doctrine 仓库在功能测试中未刷新状态的根源解析与解决方案-php教程-PHP中文网

Doctrine 仓库在功能测试中未刷新状态的根源解析与解决方案

Api Platform 功能测试中使用 RefreshDatabaseTrait 后，Doctrine 仓库仍返回过期实体数据，本质是 EntityManager 一级缓存未清理所致；需显式调用 clear() 或重构依赖注入时机，而非重复获取新 Repository 实例。

api platform 功能测试中使用 `refreshdatabasetrait` 后，doctrine 仓库仍返回过期实体数据，本质是 entitymanager 一级缓存未清理所致；需显式调用 `clear()` 或重构依赖注入时机，而非重复获取新 repository 实例。

在基于 Api Platform 和 Symfony 的功能测试中，RefreshDatabaseTrait（来自 Hautelook/Alice）通过事务回滚机制实现测试隔离——每个测试运行于独立数据库事务中，执行完毕后自动回滚，确保环境干净。这看似完美，但常引发一个隐蔽却高频的问题：Repository 查询结果未同步反映数据库真实状态。

如问题代码所示，即使已成功发送 DELETE /employees/{uuid} 请求并收到 200 响应，后续调用 $employeeRepository->count([]) 仍返回 10 而非预期的 9。根本原因并非“嵌套事务冲突”，而是 Doctrine 的 EntityManager 一级缓存（Unit of Work）未被重置。

RefreshDatabaseTrait 回滚的是数据库事务，但不会清空当前 EntityManager 实例中的已托管实体（managed entities）。当 $employeeRepository 在测试开始时被注入，其关联的 EntityManager 已加载并缓存了初始的 10 条 Employee 实体。后续 DELETE 请求由 HTTP 客户端发起，经完整请求生命周期（Controller → Service → Repository → EntityManager → DBAL）执行，该操作确实修改了数据库（在事务内），但当前测试线程持有的 EntityManager 实例并不感知外部变更——它仍认为那 10 个实体处于“托管”（managed）状态，count() 方法默认走内存快照而非重新查库。

✅ 正确解法不是反复 static::getContainer()->get(EmployeeRepository::class)（这仅获取同一容器实例，不重建 EntityManager 缓存），而是主动清理缓存：

// 在断言前添加：
$employeeRepository->getEntityManager()->clear(); // 清除所有托管实体
// 或更精准地清除特定类型：
$employeeRepository->getEntityManager()->clear(Employee::class);

⚠️ 注意：EmployeeRepository 需暴露 getEntityManager() 方法（若未继承 ServiceEntityRepository，可手动注入并提供访问器）：

// src/Repository/EmployeeRepository.php
use Doctrine\ORM\EntityRepository;

class EmployeeRepository extends EntityRepository
{
    public function getEntityManager(): EntityManagerInterface
    {
        return $this->getEntityManager();
    }
}

? 进阶建议：

避免在测试中复用 Repository 实例做跨事务断言。更健壮的写法是在断言阶段新建查询上下文，例如直接使用 EntityManager 执行原生 count 查询：

$em = static::getContainer()->get(EntityManagerInterface::class);
$count = $em->createQueryBuilder()
    ->select('COUNT(e)')
    ->from(Employee::class, 'e')
    ->getQuery()
    ->getSingleScalarResult();
static::assertEquals(9, (int)$count);

若项目启用 DQL 查询缓存（二级缓存），还需调用 $em->getCache()->evictEntityRegion(Employee::class)。
RefreshDatabaseTrait 适用于“全量重置”，若仅需部分数据隔离，可考虑 DatabaseTransactionTrait 或自定义 @BeforeTransaction/@AfterTransaction 钩子。