Symfony3+Swiftmailer+Twig邮件异常：提示发送成功却未收到邮件

我来帮你捋捋这个问题——这种"显示发送成功却收不到邮件"的情况，大多是配置细节或邮件路由的坑，咱们一步步排查：

1. 先检查Swiftmailer核心配置 #

打开app/config/config.yml，重点核对swiftmailer的传输参数：

swiftmailer:
    transport: smtp
    host: smtp.your-mail-server.com
    port: 587 # 对应tls加密，ssl一般是465
    encryption: tls
    username: your-email@example.com
    password: your-auth-code # 注意：很多邮箱（如QQ、163）需要用SMTP授权码而非登录密码
    spool: { type: memory } # 临时改成内存队列，跳过文件缓存直接发送，方便看实时错误

如果之前用的是spool: { type: file }，邮件会存在本地文件里，虽然命令行显示发送成功，但实际传输时的错误可能被隐藏。改成内存队列后，提交表单时会直接尝试发送，能直观看到是否有报错。

2. 扒开日志找隐藏错误 #

Symfony的日志藏在var/logs/目录下，开发环境看dev.log，生产环境看prod.log，搜索swiftmailer关键词：

• 有没有SMTP认证失败的提示？
• 有没有连接超时、端口不通的错误？
• 有没有收件人/发件人格式不合法的警告？
  另外可以用命令查看待发送邮件的具体内容，确认信息是否正确：

php bin/console swiftmailer:spool:show

3. 手动测试SMTP连通性 #

用命令行直接测试你的邮箱服务器，排除服务器端的限制：

# 测试tls加密的SMTP连接
openssl s_client -connect smtp.your-mail-server.com:587 -starttls smtp

连接成功后，尝试输入用户名和授权码，看能不能正常认证——有时候你以为放宽了连接限制，但邮箱可能还要求开启SMTP服务、设置授权码这些细节。

4. 检查垃圾邮件文件夹 #

别笑，这是最容易忽略的点！测试邮件内容太简单、发件人地址不规范，很容易被收件邮箱当成垃圾邮件拦截。去收件箱的垃圾邮件/垃圾箱里找找，或者给邮件加个正经的标题、真实的内容，避免触发反垃圾规则。

5. 确认命令行的执行环境 #

如果用的是文件队列，执行发送命令时要指定环境，不然可能用的是开发环境的配置：

# 生产环境要加--env参数
php bin/console swiftmailer:email:send --env=prod

同时检查spool目录的权限，确保web服务器用户（比如www-data）有读写权限，不然邮件可能无法被正确读取发送。

6. 核对控制器代码细节 #

确保你在控制器里正确触发了发送操作，举个标准示例：

/**
 * @Route("testmail", name="testmail")
 */
public function testMailAction(Request $request, \Swift_Mailer $mailer)
{
    $form = $this->createFormBuilder()
        ->add('email', EmailType::class)
        ->add('submit', SubmitType::class)
        ->getForm();

    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $data = $form->getData();
        $message = (new \Swift_Message('正经的测试邮件标题'))
            ->setFrom('your-valid-email@example.com') // 必须是SMTP认证的合法地址
            ->setTo($data['email'])
            ->setBody(
                $this->renderView('emails/test.html.twig'),
                'text/html'
            );

        // 确认调用了send方法
        $mailer->send($message);

        $this->addFlash('success', '邮件已发送！');
        return $this->redirectToRoute('testmail');
    }

    return $this->render('test/mail.html.twig', [
        'form' => $form->createView(),
    ]);
}

先从日志和配置入手，这是最快定位问题的路径，然后一步步排除SMTP连接、垃圾邮件、环境参数的坑，应该就能解决了。

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