PHPMailer+Google SMTP Relay邮件串件及重复问题排查求助

这种测试正常但生产环境出串发的问题确实头疼，结合你的场景和代码流程，我整理了几个针对性的排查方向，帮你定位问题：

1. 优先检查PHPMailer实例的复用与状态残留 #

你提到是创建一个PHPMailer实例后遍历数组发送——这大概率是核心问题！PHPMailer实例在发送完一封邮件后，收件人、内容、主题等属性会残留上一次的状态，如果循环中没有彻底重置，就会导致后续邮件串混。

• 最稳妥的方式：每次循环都新建PHPMailer实例，彻底避免状态残留：

  // 错误示范：循环外创建实例，复用导致状态残留
  $mail = new PHPMailer(true);
  foreach ($emailList as $order) {
      $mail->addAddress($order['customer_email']);
      $mail->Body = $order['tracking_info'];
      $mail->send();
  }
  
  // 正确做法：循环内新建实例，每次都是干净的状态
  foreach ($emailList as $order) {
      $mail = new PHPMailer(true);
      // 重新配置SMTP、发件人等基础参数
      $mail->isSMTP();
      $mail->Host = 'smtp-relay.gmail.com';
      $mail->SMTPAuth = true;
      // ...其他SMTP配置
      // 设置当前邮件的专属内容
      $mail->addAddress($order['customer_email']);
      $mail->Subject = '你的物流追踪信息';
      $mail->Body = $order['tracking_info'];
      $mail->send();
  }
  

• 如果要复用实例（比如追求性能），必须在每次循环后强制清理所有状态：

  foreach ($emailList as $order) {
      // 清空所有收件人、抄送、密送
      $mail->clearAddresses();
      $mail->clearCCs();
      $mail->clearBCCs();
      // 重置内容、主题、附件
      $mail->Subject = '';
      $mail->Body = '';
      $mail->clearAttachments();
      // 再设置当前邮件的属性
      $mail->addAddress($order['customer_email']);
      $mail->Body = $order['tracking_info'];
      $mail->send();
  }
  

2. 验证Google SMTP Relay的会话与速率限制 #

Google SMTP Relay有隐性的会话复用和速率限制，可能导致邮件属性串混：

• 尝试在每次发送后主动关闭SMTP连接，避免复用会话带来的状态残留：

  try {
      $mail->send();
      $mail->smtpClose(); // 发送完立即断开连接
  } catch (Exception $e) {
      // 处理错误与重试逻辑
  }
  

• 登录Google Workspace管理后台，查看邮件发送日志，排查是否有异常的会话合并或速率限制触发记录。

3. 确认Windows任务计划的实际执行状态 #

虽然你设置了“不允许同时运行多个实例”，但Windows任务计划偶尔会因为前一次脚本未正常退出（比如PHP进程卡死、脚本超时）而启动新实例，多个进程同时遍历邮件数组就会导致串发：

• 查看Windows事件查看器的任务计划日志，确认是否存在多实例同时运行的记录；
• 在脚本开头添加进程锁，彻底避免并发执行：

  $lockFile = __DIR__ . '/mail_send.lock';
  $lockHandle = fopen($lockFile, 'w');
  // 尝试获取排他锁，失败则说明已有进程在运行
  if (!flock($lockHandle, LOCK_EX | LOCK_NB)) {
      exit('已有邮件发送进程在运行，本次执行终止');
  }
  // ...脚本核心逻辑
  // 脚本结束时释放锁并删除临时文件
  flock($lockHandle, LOCK_UN);
  fclose($lockHandle);
  unlink($lockFile);
  

4. 增加详细日志，追踪每一封邮件的全流程 #

测试阶段的同地址负载测试无法暴露串发问题，生产环境必须靠精准日志定位：

• 在每次发送前，记录当前邮件的收件人、内容摘要、时间戳；发送后记录成功/失败状态：

  $logFile = __DIR__ . '/mail_tracking.log';
  foreach ($emailList as $order) {
      // 记录准备发送的信息
      $preLog = date('Y-m-d H:i:s') . " | 待发送: {$order['customer_email']} | 物流单号: {$order['tracking_no']}\n";
      file_put_contents($logFile, $preLog, FILE_APPEND);
      try {
          $mail->send();
          $successLog = date('Y-m-d H:i:s') . " | 发送成功: {$order['customer_email']}\n";
          file_put_contents($logFile, $successLog, FILE_APPEND);
      } catch (Exception $e) {
          $errorLog = date('Y-m-d H:i:s') . " | 发送失败: {$order['customer_email']} | 错误: {$e->getMessage()}\n";
          file_put_contents($logFile, $errorLog, FILE_APPEND);
          // 重试逻辑
      }
  }
  

通过对比用户反馈的错误邮件内容和日志，就能精准定位是哪一次循环出现了串发。

5. 检查变量赋值的作用域与引用问题 #

确认遍历数组时，邮件内容的变量是否被正确赋值：

• 避免使用引用遍历数组元素（foreach ($emailList as &$item)），引用可能导致后续循环意外修改之前的元素；
• 确保邮件内容是直接从当前循环的数组元素中获取，而非依赖外部全局变量。

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