Symfony 4中SwiftMailer发送Gmail邮件未送达问题求助

我之前也碰到过类似的邮件投递问题，结合Symfony 4和Gmail的配置经验，给你几个实用的排查方向：

1. 先搞定Gmail的安全权限（不止“允许不安全应用”） #

• 如果你的Gmail账号是2022年之后创建的，“允许不安全应用”这个选项已经被Google移除了，必须改用应用专用密码：
  1. 先开启Google账号的两步验证
  2. 生成一个专门给Symfony用的应用密码，替换.env里的PASSWORD字段
• 另外去Google账号的「最近安全活动」里查一下，说不定Gmail已经拦截了你的应用请求，需要手动确认信任

2. 修正.env里的MAILER_URL格式 #

Symfony 4里gmail://协议偶尔会有兼容性问题，换成标准SMTP格式更稳妥：

# 推荐的SMTP格式（带TLS加密）
MAILER_URL=smtp://smtp.gmail.com:587?encryption=tls&username=ep****@gmail.com&password=你的应用专用密码

如果坚持用gmail://协议，记得补充加密和认证参数：

MAILER_URL=gmail://ep****@gmail.com:你的应用专用密码@localhost?encryption=tls&auth_mode=login

3. 确认队列是否在正常消费 #

既然邮件已经进入队列，得确保队列消费者在运行：

• 如果用的是Symfony Messenger队列，执行命令启动消费者：php bin/console messenger:consume async
• 如果是Swift Mailer自带的spool，需要手动触发发送：php bin/console swiftmailer:spool:send
• 检查swiftmailer.yaml的spool配置，确认类型和权限：

swiftmailer:
    url: '%env(MAILER_URL)%'
    spool: { type: memory } # 若用file类型，要确保对应目录有读写权限

4. 跳过队列，直接测试邮件发送 #

先在AccountController.php里写个测试方法，直接发送邮件不进队列，看是否有报错：

// src/Controller/AccountController.php
public function testDirectEmail(\Swift_Mailer $mailer)
{
    $message = (new \Swift_Message('Symfony测试邮件'))
        ->setFrom('ep****@gmail.com')
        ->setTo('你的目标Gmail邮箱')
        ->setBody('这是跳过队列的测试邮件');

    try {
        $mailer->send($message);
        dump('邮件发送成功！');
    } catch (\Exception $e) {
        dump('发送失败：' . $e->getMessage());
    }

    return new \Symfony\Component\HttpFoundation\Response('测试完成');
}

访问这个接口，能快速定位是发送环节还是队列环节出了问题

5. 查看Symfony日志找细节 #

去var/log/dev.log（开发环境）或var/log/prod.log（生产环境）里搜索swiftmailer相关日志，里面会有认证失败、连接超时这类关键报错信息，是排查问题的核心依据

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