使用PHPUnit测试Twig render方法失败：期望调用1次实际0次

你遇到的这个问题其实很典型——你成功创建了Twig环境的Mock对象，也设置了调用期望，但你没有把这个Mock注入到实际要测试的Mailer类中，也没有触发Mailer里会调用render方法的业务逻辑，这就导致Mock的render方法根本没机会被调用。

核心原因拆解 #

你的测试代码只完成了两步：定义Mock对象、设置调用期望，但缺失了最关键的两个环节：

• 没有实例化目标测试类Mailer，并将Twig Mock传递给它作为依赖
• 没有调用Mailer类中会触发Twig render方法的具体业务方法（比如发送确认邮件的方法）

修正后的测试代码示例 #

假设你的Mailer类位于App\Mailer\Mailer，且构造函数接收Twig\Environment作为参数，修正后的测试代码应该是这样的：

<?php
namespace App\Tests\Mailer;

use App\Mailer\Mailer; // 引入要测试的Mailer类
use PHPUnit\Framework\TestCase;
use Twig\Environment;

class MailerTest extends TestCase
{
    public function testConfirmationEmail()
    {
        // 创建Twig环境的Mock，禁用原始构造函数（因为Twig构造需要Loader依赖）
        $twigMock = $this->getMockBuilder(Environment::class)
            ->disableOriginalConstructor()
            ->getMock();

        // 设置期望：render方法被调用一次
        $twigMock->expects($this->once())
            ->method('render');

        // 实例化Mailer类，将Twig Mock注入进去
        $mailer = new Mailer($twigMock);

        // 调用Mailer中会触发render的业务方法（这里假设是sendConfirmationEmail）
        $mailer->sendConfirmationEmail('test@example.com');
    }
}

额外排查点 #

如果修正后测试还是失败，可以检查这几个地方：

• 确认Mailer类的构造函数确实接收Twig\Environment实例作为依赖
• 确认你调用的Mailer方法内部，确实存在$this->twig->render()的调用逻辑
• 如果Mailer中的方法是异步执行的（比如依赖消息队列），要确保测试中同步触发了执行流程

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