SMTP服务器宕机时Symfony邮件发送遇Cloudflare 504超时问题

本地环境中，使用Symfony\Component\Mime\Email结合try/catch发送邮件时，SMTP服务器（Mailhog）宕机，try/catch能正常捕获TransportExceptionInterface异常；但生产环境下SMTP宕机时，页面加载数秒后直接显示Cloudflare的“网关超时 错误代码504”页面，try/catch完全没生效。

代码示例：

...
try {
    $this->mailer->send($mail);
    $this->addFlash('success', "Form sent");
} catch (TransportExceptionInterface $e) {
    $this->addFlash('danger', "Error when sending the form, please try later");
}
...

请问为何生产环境中try/catch不生效？是否与Cloudflare有关？

1. 核心原因：SMTP连接超时时间过长，超过Cloudflare阈值 #

Cloudflare默认HTTP请求超时时间为100秒（部分套餐可能更短），而Symfony Mailer的SMTP客户端默认超时设置可能高于这个值。当SMTP服务器宕机时，客户端会持续尝试建立连接，直到达到自身超时上限——这个过程中Cloudflare先触发504超时，直接返回错误页面，你的PHP代码还没来得及执行catch逻辑。

本地环境用Mailhog时，本地网络连接超时更快，Symfony能在Cloudflare超时前抛出异常并被捕获；但生产环境网络链路更长，或Symfony的SMTP超时设置过高，导致Cloudflare先终止了请求。

2. 与Cloudflare的关系：间接关联，非直接原因 #

Cloudflare的504是结果，不是try/catch失效的根源。本质是代码在Cloudflare超时前未完成异常捕获和响应输出。

3. 解决办法 #

• 缩短Symfony Mailer的SMTP超时时间：在邮件传输配置中设置更短的超时，确保在Cloudflare超时前触发异常。例如在config/packages/mailer.yaml中配置：

  framework:
      mailer:
          transports:
              main:
                  dsn: 'smtp://your-smtp-server:port'
                  options:
                      connection_timeout: 5
                      timeout: 5
  

  connection_timeout是建立连接的超时，timeout是数据传输的超时，均设置为5秒左右，远低于Cloudflare的100秒阈值。

• 异步发送邮件：改用Symfony Messenger将邮件发送任务异步处理，请求会立即返回，邮件发送在后台执行，即使SMTP宕机也不会阻塞用户请求，自然不会触发Cloudflare超时。

• 检查异常捕获配置：确认TransportExceptionInterface已正确导入（use Symfony\Component\Mailer\Exception\TransportExceptionInterface;），生产环境的PHP错误级别未屏蔽相关异常（此情况概率较低，核心仍为超时问题）。

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