如何解决Symfony 5.3控制台发邮件无报错但未发送问题

Symfony 5.3环境下网页端发信正常，说明邮件DSN配置、发信权限、传输规则均无问题，故障核心是CLI命令与HTTP请求的生命周期逻辑差异：

• HTTP请求结束时会触发kernel.terminate事件，Symfony Mailer默认监听该事件，自动刷送内存中暂存的待发邮件
• 控制台命令执行完成后直接退出PHP进程，不会自动触发上述邮件刷送逻辑，代码中调用send()仅将邮件存入内存队列，未真正提交给邮件传输层，因此既无报错，也无法实际收到邮件。

根据项目是否启用Messenger组件分场景处理：

未启用Messenger组件（默认配置场景） #

在调用send()方法后，手动触发传输层的队列刷送逻辑即可，修正后的代码如下：

protected function execute(InputInterface $input, OutputInterface $output): int
{
    $io = new SymfonyStyle($input, $output);
    $email = (new Email())
        ->from('*****')
        ->to('*****')
        ->subject('test')
        ->html('test');

    $this->mailer->send($email);
    // CLI环境必须添加下一行，手动刷送待发邮件
    $this->mailer->getTransport()->flush();

    $io->success('Export terminé');
    return 0;
}

如果依赖注入绑定的是MailerInterface接口，无法直接调用getTransport()方法，直接在命令构造函数中额外注入Symfony\Component\Mailer\Transport\TransportInterface实例，调用该实例的flush()方法即可。

已启用Messenger组件做异步发信的场景 #

这种场景下send()方法会把邮件任务推送到Messenger异步队列，不会直接发信：

• 需要命令执行时立即发信，可临时将邮件路由到同步总线处理
• 保留异步逻辑的前提下，执行命令后需要手动运行消费命令处理队列任务：

php bin/console messenger:consume async -vv

如果调整后还是收不到邮件，执行控制台命令时追加-vvv参数开启最高级别verbose输出，就能直接看到Mailer组件的完整执行日志，确认邮件是被环境拦截、入队还是发送失败。

内容的提问来源于stack exchange，提问作者Matthieu Planté