Symfony 6 Mailer发信报could not find driver异常问题咨询

问题背景 #

基于Symfony框架搭配Mailer组件开发联系表单功能，配置与代码如下，运行时抛出An exception occurred in the driver: could not find driver错误，暂未定位到配置遗漏点。

现有配置与代码 #

.env 文件Mailer配置 #

###> symfony/mailer ###
MAILER_DSN=smtp://localhost:1025
###< symfony/mailer ###

ContactController.php 表单提交处理代码 #

if($form->isSubmitted() && $form->isValid()) {

    $contactFormData = $form->getData();
        
    $message = (new Email())
        ->from($contactFormData['mail'])
        ->to('XXXX@gmail.com')
        ->subject('Envoi depuis la page Contact par '.$contactFormData['name'])
        ->text($contactFormData['message']);
    $mailer->send($message);

    $this->addFlash('success', 'Your message has been sent');

    return $this->redirectToRoute('app_contact');
}

错误信息 #

运行代码触发异常：An exception occurred in the driver: could not find driver

问题定位与修复方案 #

这个报错和数据库驱动无关，是Mailer组件传输层依赖缺失或配置不匹配导致，按以下顺序排查：

• 安装缺失的PHP扩展：Symfony Mailer使用smtp://协议发送邮件时，依赖sockets扩展完成套接字连接，同时邮件编码处理需要mbstring扩展支持。
  • Debian/Ubuntu环境执行命令安装对应扩展：sudo apt install php-sockets php-mbstring，安装完成后重启PHP-FPM或Web服务器（Nginx/Apache）
  • Windows环境编辑php.ini配置文件，移除extension=sockets、extension=mbstring两行前的注释分号，保存后重启Web服务
• 校验本地SMTP服务状态：配置中指定的localhost:1025是MailHog、Mailpit等本地邮件测试工具的默认SMTP端口，确认对应测试工具已经正常启动、1025端口未被其他服务占用。如果仅做本地功能调试不需要真实发信，可以直接把MAILER_DSN修改为MAILER_DSN=null://null，所有邮件会写入Symfony运行日志，不会真实对外发送，适合开发环境使用。
• 检查类引入与缓存：确认控制器顶部已经正确引入Mailer和Email相关类，包含以下两条use语句：

  use Symfony\Component\Mime\Email;
  use Symfony\Component\Mailer\MailerInterface;
  

  所有配置修改完成后，执行php bin/console cache:clear清理Symfony配置缓存，避免旧缓存导致异常。

内容的提问来源于stack exchange，提问作者Noé Femeland