如何屏蔽PHPMailer错误提示（邮件发送成功仍显示报错）

问题核心原因 #

两个异常现象分别对应两个配置/逻辑错误：

1. 页面输出SMTP通信日志：仅设置$mail->SMTPDebug = 0未完全截断调试输出通道，部分版本PHPMailer存在默认输出回调残留。
2. 成功发送后显示Error: Email sent successfully：业务层判断逻辑写反/分支未隔离，PHPMailer发送成功时ErrorInfo属性默认值就是Email sent successfully，如果成功场景也走到了错误输出分支，就会出现这个异常提示。

分步修复操作 #

• 彻底关闭PHPMailer调试输出
  不要仅设置SMTPDebug参数，显式定义空的调试输出回调，从底层阻断调试信息打印到页面：

  // 完全关闭SMTP交互调试
  $mail->SMTPDebug = 0;
  // 重写调试输出方法，所有调试信息不向页面输出，需要留存日志可自行写入文件
  $mail->Debugoutput = function($str, $level) {
      // 日志留存示例（可选）：
      // file_put_contents(__DIR__.'/mail_debug.log', date('[Y-m-d H:i:s]').$str.PHP_EOL, FILE_APPEND);
  };
  

• 修正发送结果判断逻辑，隔离成功/失败分支
  你遇到的错误提示本质是成功、失败的输出逻辑混写导致的，使用异常模式编写发送逻辑，严格区分两个分支，不要在成功分支输出错误前缀：

  // 引入PHPMailer类（根据你自己的引入路径调整）
  use PHPMailer\PHPMailer\PHPMailer;
  use PHPMailer\PHPMailer\Exception;
  
  // 实例化时传入true开启异常捕获，方便精准判断错误
  $mail = new PHPMailer(true);
  
  // 提前设置响应头，避免输出乱码，如果是接口返回用json格式
  header('Content-Type: application/json; charset=utf-8');
  // 关闭PHP错误直接输出到页面，错误统一写入日志，适配本地/Heroku环境
  ini_set('display_errors', 0);
  ini_set('log_errors', 1);
  
  try {
      // Gmail SMTP基础配置
      $mail->isSMTP();
      $mail->Host = 'smtp.gmail.com';
      $mail->SMTPAuth = true;
      $mail->Username = '你的Gmail账号';
      $mail->Password = '你的Gmail应用专用密码'; // 注意Gmail需要用应用专用密码，不能用账号原密码
      $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
      $mail->Port = 587;
  
      // 上面提到的debug关闭配置
      $mail->SMTPDebug = 0;
      $mail->Debugoutput = function($str, $level){};
  
      // 此处省略发件人、收件人、邮件主题、正文等配置逻辑
  
      // 执行发送
      $mail->send();
      // 发送成功分支：只返回成功提示，执行exit阻断后续代码执行
      echo json_encode([
          'code' => 200,
          'msg' => '邮件发送成功'
      ]);
      exit;
  
  } catch (Exception $e) {
      // 只有捕获到异常才是真的发送失败，此时才返回错误信息
      echo json_encode([
          'code' => 500,
          'msg' => '邮件发送失败：' . $mail->ErrorInfo
      ]);
      exit;
  }
  

  注意：成功分支执行完输出后必须加exit，避免后续的错误输出逻辑被执行。

• 额外适配Heroku环境
  Heroku默认会开启PHP错误前端显示，如果按上面配置加了ini_set('display_errors', 0)，就不会有平台层面的错误信息输出到页面，所有错误只会记录到Heroku的平台日志中，不影响前端正常响应。

验证标准 #

配置修改完成后测试：

1. 邮件正常送达时，页面无SMTP调试日志输出，只返回成功提示
2. 只有当SMTP配置错误、账号密码错误等真实发送失败场景，才会返回错误提示
3. 本地、Heroku环境表现一致

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