Symfony PHPUnit测试报错：无法实例化EntityManagerInterface

错误信息 #

1. App\Tests\PaymentControllerTest::testProcessPaymentSuccess
   Error: Cannot instantiate interface Doctrine\ORM\EntityManagerInterface

已尝试的无效方案 #

• 为包括EntityManagerInterface在内的所有依赖创建模拟对象
• 更新services_test.yaml配置，设置测试环境下服务为公开
• 使用self::getContainer()->set将模拟对象注入测试容器

Symfony依赖注入容器仍尝试直接实例化接口，导致错误。

正确配置模拟对象的方法 #

方法1：单元测试手动注入模拟对象（推荐） #

如果是纯单元测试，不需要完整容器支持，直接通过构造函数注入模拟依赖：

use Doctrine\ORM\EntityManagerInterface;
use PHPUnit\Framework\MockObject\MockObject;
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;

class PaymentControllerTest extends WebTestCase
{
    private MockObject|EntityManagerInterface $entityManagerMock;
    private PaymentController $controller;

    protected function setUp(): void
    {
        // 创建EntityManagerInterface模拟对象
        $this->entityManagerMock = $this->createMock(EntityManagerInterface::class);
        
        // 模拟其他依赖
        $invoiceRepoMock = $this->createMock(InvoiceRepository::class);
        $invoiceServiceMock = $this->createMock(InvoiceService::class);
        $httpClientMock = $this->createMock(HttpClientInterface::class);
        
        // 直接实例化控制器并注入所有模拟依赖
        $this->controller = new PaymentController(
            $this->entityManagerMock,
            $invoiceRepoMock,
            $invoiceServiceMock,
            $httpClientMock
        );
    }

    public function testProcessPaymentSuccess(): void
    {
        // 配置模拟对象的预期行为
        $this->entityManagerMock->method('persist')->willReturn(null);
        $this->entityManagerMock->method('flush')->willReturn(null);
        
        // 执行测试逻辑
        $response = $this->controller->processPayment(...);
        
        // 断言结果
        $this->assertEquals(200, $response->getStatusCode());
        // 其他业务断言...
    }
}

方法2：功能测试中替换容器服务 #

如果需要使用完整容器的功能测试，可通过两种方式替换服务：

1. 配置文件预定义
   在config/services_test.yaml中直接配置模拟服务：

services:
    _defaults:
        public: true
        autowire: true
        autoconfigure: true

    Doctrine\ORM\EntityManagerInterface:
        class: PHPUnit\Framework\MockObject\MockObject
        factory: ['Symfony\Bundle\FrameworkBundle\Test\WebTestCase', 'createMock']

2. 测试中动态替换
   在测试类的setUp方法中替换容器服务：

protected function setUp(): void
{
    parent::setUp();
    $entityManagerMock = $this->createMock(EntityManagerInterface::class);
    
    // 必须在parent::setUp()之后调用，确保容器已初始化
    self::getContainer()->set(EntityManagerInterface::class, $entityManagerMock);
}

方法3：使用真实EntityManager（需数据库交互场景） #

如果测试需要部分真实的Doctrine操作，可使用Symfony的Doctrine测试工具：

use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Doctrine\ORM\EntityManager;

class PaymentControllerTest extends KernelTestCase
{
    private EntityManager $entityManager;

    protected function setUp(): void
    {
        $kernel = self::bootKernel();
        $this->entityManager = $kernel->getContainer()
            ->get('doctrine')
            ->getManager();
    }

    protected function tearDown(): void
    {
        parent::tearDown();
        $this->entityManager->close();
        $this->entityManager = null;
    }

    public function testProcessPaymentSuccess(): void
    {
        // 开启事务，测试后回滚避免污染数据库
        $this->entityManager->beginTransaction();
        try {
            // 执行测试逻辑
            $this->entityManager->rollback();
        } catch (\Exception $e) {
            $this->entityManager->rollback();
            throw $e;
        }
    }
}

常见排查点 #

• 确保测试类继承WebTestCase（功能测试）或KernelTestCase（内核测试），而非普通PHPUnit测试类。
• 检查控制器是否通过构造函数注入EntityManagerInterface，而非使用$this->getDoctrine()（后者会绕开容器注入逻辑）。
• 使用self::getContainer()->set时，必须在调用控制器方法前完成替换，避免容器提前初始化服务实例。

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