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钩子。
总结：Doctrine 的缓存设计以性能为先，但在测试场景下需开发者主动管理生命周期。理解 EntityManager::clear() 的语义（解除所有实体托管关系，强制后续查询走数据库）是写出可靠功能测试的关键一环。
