Symfony4中SwiftMailer无法发送邮件：SMTP参数配置错误？

别着急，我来帮你一步步搞定这两个问题！

首先咱们先排查邮件配置和发送的核心问题，按以下步骤来：

• 检查.env文件的邮件配置
  Symfony4中SwiftMailer的配置主要靠.env里的MAILER_URL参数，比如用SMTP服务商的话，配置大概是这样：

  MAILER_URL=smtp://your_username:your_password@smtp.example.com:587?encryption=tls&auth_mode=login
  

  注意替换成你实际的邮箱账号、密码（如果是Gmail需要用应用专用密码，不是普通密码）、SMTP地址和端口。如果用本地sendmail，配置可以写成MAILER_URL=sendmail://localhost。

• 用命令行测试邮件发送
  直接用Symfony的内置命令测试，能快速定位是配置问题还是代码问题：

  php bin/console swiftmailer:email:send
  

  按照提示输入发件人、收件人和内容，执行后看有没有报错。如果命令行能发送成功，那就是你控制器里的代码有问题；如果命令行也失败，那就是配置或者服务器环境的问题（比如服务器防火墙拦截了SMTP端口）。

• 检查控制器代码的正确性
  确保你正确注入了Swift_Mailer，并且邮件参数设置正确，比如发件人、收件人、内容都没问题，示例代码：

  use Symfony\Component\HttpFoundation\Response;
  use Swift_Mailer;
  use Swift_Message;
  use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
  use Symfony\Component\HttpFoundation\Request;
  
  class ContactController extends AbstractController
  {
      public function sendContactEmail(Request $request, Swift_Mailer $mailer)
      {
          // 获取表单数据
          $email = $request->request->get('email');
          $messageContent = $request->request->get('message');
  
          // 构建邮件（建议用自己验证过的官方邮箱作为发件人，避免被当成垃圾邮件）
          $message = (new Swift_Message('来自联系表单的消息'))
              ->setFrom('your-official-email@example.com')
              ->setTo('your-admin-email@example.com')
              ->setBody("发件人邮箱：{$email}\n消息内容：{$message}", 'text/plain');
  
          // 发送邮件并捕获错误
          try {
              $mailer->send($message);
          } catch (\Exception $e) {
              // 记录错误日志方便排查
              error_log('邮件发送失败：'.$e->getMessage());
          }
      }
  }
  

• 查看日志找错误
  去var/log/dev.log（开发环境）或者var/log/prod.log（生产环境）里找相关的错误日志，比如SMTP连接超时、认证失败、收件人无效这些信息，根据日志提示调整配置或者代码。

要做到页面不刷新就返回结果，需要结合AJAX请求和JSON响应：

• 控制器返回JSON响应
  修改你的控制器方法，让它接收Request对象，判断是否是AJAX请求，然后返回JSON格式的结果：

  use Symfony\Component\HttpFoundation\JsonResponse;
  use Symfony\Component\HttpFoundation\Request;
  use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
  use Swift_Mailer;
  use Swift_Message;
  
  class ContactController extends AbstractController
  {
      public function handleContactForm(Request $request, Swift_Mailer $mailer)
      {
          // 检查是否是AJAX请求
          if (!$request->isXmlHttpRequest()) {
              return new JsonResponse(['status' => 'not OK', 'msg' => '无效请求'], 400);
          }
  
          // 验证表单数据（可以用Symfony Form组件更规范，这里先手动验证）
          $email = $request->request->get('email');
          $message = $request->request->get('message');
          $errors = [];
  
          if (empty($email) || !filter_var($email, FILTER_VALIDATE_EMAIL)) {
              $errors[] = '请输入有效的邮箱地址';
          }
          if (empty($message)) {
              $errors[] = '请输入消息内容';
          }
  
          if (!empty($errors)) {
              return new JsonResponse(['status' => 'not OK', 'errors' => $errors]);
          }
  
          // 发送邮件
          try {
              $mailMessage = (new Swift_Message('联系表单消息'))
                  ->setFrom('your-official-email@example.com')
                  ->setTo('your-admin-email@example.com')
                  ->setBody("发件人邮箱：{$email}\n消息内容：{$message}", 'text/plain');
  
              $mailer->send($mailMessage);
              return new JsonResponse(['status' => 'OK', 'msg' => '邮件发送成功']);
          } catch (\Exception $e) {
              error_log('邮件发送失败：'.$e->getMessage());
              return new JsonResponse(['status' => 'not OK', 'msg' => '邮件发送失败，请稍后重试']);
          }
      }
  }
  

• 前端用AJAX提交表单
  给你的联系表单添加JavaScript代码，阻止默认的表单提交行为，用AJAX发送请求：

  // 获取表单元素
  const contactForm = document.getElementById('contact-form');
  
  contactForm.addEventListener('submit', function(e) {
      // 阻止表单默认提交（避免页面刷新）
      e.preventDefault();
  
      // 收集表单数据
      const formData = new FormData(this);
  
      // 发送AJAX请求
      fetch(this.action, {
          method: 'POST',
          body: formData,
          // 告诉后端这是AJAX请求
          headers: {
              'X-Requested-With': 'XMLHttpRequest'
          }
      })
      .then(response => response.json())
      .then(data => {
          // 根据返回的结果处理
          if (data.status === 'OK') {
              alert(data.msg);
              // 可以重置表单
              contactForm.reset();
          } else {
              // 显示错误信息
              alert('提交失败：' + data.errors?.join('\n') || data.msg);
          }
      })
      .catch(error => {
          console.error('请求出错：', error);
          alert('网络出错，请稍后重试');
      });
  });
  

• 路由配置注意事项
  确保你的路由允许POST请求，比如在config/routes.yaml里：

  contact_form:
      path: /contact/send
      controller: App\Controller\ContactController::handleContactForm
      methods: [POST]
  

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