PHPMailer5.2.28 SMTP连接失败后有效错误信息被覆盖丢失解决问询

以下方案均适配5.x版本，无需升级到PHPMailer 6，可根据场景选择：

方案1：无需修改核心源码，通过调试日志捕获原始错误 #

该方案不会改动PHPMailer的任何核心文件，兼容性最高：

• 初始化PHPMailer实例时，开启SMTP调试并自定义日志存储回调，避免调试信息直接输出到页面：

$mail = new PHPMailer();
// 原有配置保持不变，新增以下配置
$mail->SMTPDebug = 2; // 调试级别2可返回完整的连接、交互错误信息
$smtp_debug_log = '';
$mail->Debugoutput = function($log_str, $level) use (&$smtp_debug_log) {
    $smtp_debug_log .= $log_str . PHP_EOL;
};

• 发信失败后，直接读取$smtp_debug_log变量即可获取完整的原始报错，包含主机不可达、端口被拒绝、服务端返回的配额超限等具体原因。

方案2：最小改动PHPMailer核心代码，让ErrorInfo直接返回原始错误 #

如果需要让PHPMailer自带的ErrorInfo属性直接返回有效错误，只需修改1处核心代码：

• 打开class.phpmailer.php，找到smtpConnect方法中连接失败后调用$this->smtp->close()的代码行（5.2.28版本位于1727行附近），修改为以下内容：

// 暂存SMTP对象中已记录的原始错误
$saved_smtp_error = $this->smtp->getError();
$this->smtp->close();
// 关闭连接后将错误写回，避免丢失
$this->smtp->setError(
    $saved_smtp_error['error'],
    $saved_smtp_error['detail'],
    $saved_smtp_error['smtp_code'],
    $saved_smtp_error['smtp_code_ex']
);

• 修改完成后，发信失败时读取$mail->ErrorInfo即可直接看到原始错误详情，无需额外处理日志。

方案3：修改SMTP类close方法，禁止关闭连接时清空错误 #

该方案改动更小，仅需删除1行代码：

• 打开class.smtp.php，找到close方法中的$this->setError('');代码行，直接注释或删除即可。
• 修改后close操作仅会断开Socket连接，不会清空已记录的错误信息，原有逻辑下PHPMailer即可正常读取到连接错误详情。

补充说明：若你遇到的是Gmail发信配额超限导致的连接拒绝，可直接将SMTP主机替换为smtp-relay.gmail.com即可解决配额限制问题。

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