使用PHPMailer调用Gmail SMTP批量发件时部分出现SMTP connect失败问题

我碰到过好几个开发者遇到类似的Gmail+PHPMailer批量发送问题，你的情况大概率是Gmail的限流机制或者连接配置的小问题导致的，咱们一步步来排查解决：

首先先纠正一个明显的配置错误——你代码里$mail->SMTPsecure = "ssl"但搭配了Port = 587，这是不匹配的：

• 587端口对应的是TLS加密，应该设置$mail->SMTPsecure = 'tls';
• 465端口才对应ssl，这个配置不匹配会导致连接不稳定，偶尔成功偶尔失败，这可能是你问题的诱因之一。

接下来针对批量发送失败的核心问题，给出几个关键解决办法：

1. 应对Gmail的发送频率限制 #

Gmail对免费账户的发送限制很严格：

• 免费账户每天最多发送500封，但更关键的是短时间内的高频发送会触发临时限流（比如几分钟内发几十封），哪怕没到日限额，Gmail也会临时阻断你的连接，导致后续邮件失败。
• 如果你是G Suite（Workspace）账户，限额更高，但同样有短时间内的发送频率限制。

解决办法：

• 在循环中添加合理的延迟，比如每发10封暂停2-3秒，或者每发一封暂停0.5秒，避免触发高频检测：

  // 发送邮件后添加延迟，可根据情况调整时长
  sleep(1);
  

• 拆分发送批次，比如一次发50封，隔10分钟再发下一批，而不是一次性发完100封。

2. 优化PHPMailer的连接复用 #

你现在在循环外创建PHPMailer实例的做法是对的，但要确保每次发送后正确重置收件人，并且处理连接断开的情况：

• 每次循环里必须调用$mail->clearAddresses();清空上一个收件人，避免收件人叠加
• 如果遇到连接断开，可显式重新连接后重试发送，示例代码如下：

  // 循环外创建并配置PHPMailer实例（已修正加密配置）
  $mail = new PHPMailer();
  $mail->IsSMTP();
  $mail->SMTPDebug = 0;
  $mail->SMTPsecure = "tls"; // 修正为tls，对应587端口
  $mail->SMTPAuth = true;
  $mail->Host = "smtp.gmail.com";
  $mail->Port = 587;
  $mail->Username = "your-email@gmail.com";
  $mail->Password = "your-app-password"; // 开了2FA的话用应用密码
  $mail->SetFrom("your-email@gmail.com");
  $mail->isHTML(true);
  $mail->CharSet = "utf-8";
  $mail->Subject = $msgsubject;
  $mail->AltBody = "Invitation";
  
  do {
      // 清空上一次的收件人
      $mail->clearAddresses();
      $membername = $row_musicians['name'];
      $emailaddress = $row_musicians['email'];
      // 添加当前收件人
      $mail->AddAddress($emailaddress);
      $mail->Body = 'Dear '.$membername.', <p>'.$maintext.'</p>';
      
      // 尝试发送，失败则重新连接重试
      if (!$mail->Send()) {
          $mail->smtpClose();
          if (!$mail->smtpConnect()) {
              echo "无法重新连接，跳过收件人: $emailaddress\n";
              continue;
          }
          // 再次尝试发送
          if ($mail->Send()) {
              echo "重新连接后发送成功: $emailaddress\n";
          } else {
              echo "发送失败: $emailaddress，错误信息: ".$mail->ErrorInfo."\n";
          }
      } else {
          echo "发送成功: $emailaddress\n";
      }
      // 添加延迟避免限流
      sleep(1);
  } while (...); // 你的循环条件
  

3. 确保使用正确的验证方式 #

如果你开启了Google账户的两步验证（2FA），直接用账户密码是无法通过SMTP验证的，必须使用应用密码：

• 登录Google账户，进入「安全」设置，找到「应用密码」（需开启2FA才能看到）
• 创建一个专门用于PHPMailer的应用密码，替换代码里的$mail->Password值。

4. 开启SMTP调试精准排查 #

把$mail->SMTPDebug = 2;（之前是0），这样可以看到详细的SMTP连接日志，当出现失败时，能看到Gmail返回的具体错误提示（比如限流通知、验证错误等），帮助你更精准定位问题。

最后提醒下：Gmail免费账户并不适合大规模批量发送邮件，如果你经常需要发送几十上百封邮件，建议使用专业的邮件发送服务，它们的限流机制更宽松，可靠性更高。

内容的提问来源于stack exchange，提问作者Predrag Vasić