PHP脚本通过cURL测试时返回完整SMTP日志的问题排查

问题出在PHPMailer默认开启了SMTP调试输出，会把交互日志直接输出到HTTP响应中，导致JSON结果被日志内容污染。以下是具体解决方法：

1. 彻底关闭调试输出（最直接的解决方案） #

PHPMailer的SMTPDebug属性控制调试日志的输出级别，将其设置为0即可关闭所有调试输出：

// 初始化PHPMailer实例后添加这行代码
$mail->SMTPDebug = 0;

补充说明：SMTPDebug的可选值：

• 0：关闭调试（无输出）
• 1：输出简单的SMTP状态信息
• 2：输出完整的SMTP交互日志（就是你现在看到的敏感内容）
• 3：输出更详细的连接、认证等细节日志

2. 保留日志但不输出到响应（如需调试时使用） #

如果需要保留调试日志但不想让它出现在HTTP响应里，可以将日志定向到变量或文件：

// 初始化PHPMailer实例后设置日志回调
$debugLog = '';
$mail->Debugoutput = function($str, $level) use (&$debugLog) {
    // 将日志内容存入变量
    $debugLog .= "[$level] $str\n";
};

// 发送邮件后，可将日志写入文件（可选）
file_put_contents('mail_debug.log', $debugLog, FILE_APPEND | LOCK_EX);

3. 清理输出缓冲（应急方案） #

如果暂时无法修改调试设置，可通过输出缓冲提前拦截所有输出：

// 在脚本最开头开启输出缓冲
ob_start();

// ... 你的PHPMailer初始化和发送代码 ...

// 在输出JSON前清空缓冲
ob_clean();
http_response_code(200);
exit(json_encode(["message"=>"Mails sent successfully!"]));

注意：此方案仅当日志内容还在输出缓冲中时有效，如果日志已经被直接输出到客户端（未开缓冲时），ob_clean无法收回已发送的内容，因此优先推荐前两种方法。

完整示例代码 #

require 'PHPMailer/PHPMailer.php';
require 'PHPMailer/SMTP.php';
require 'PHPMailer/Exception.php';

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

// 开启输出缓冲（可选，保险用）
ob_start();

$mail = new PHPMailer(true);

// 关闭调试输出
$mail->SMTPDebug = 0;

// 配置SMTP参数
$mail->isSMTP();
$mail->Host = 'smtp.example.com';
$mail->SMTPAuth = true;
$mail->Username = 'your_email@example.com';
$mail->Password = 'your_smtp_password';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port = 465;

// 设置邮件内容
$mail->setFrom('sender@example.com', 'Sender');
$mail->addAddress('recipient@example.com', 'Recipient');
$mail->Subject = 'Test Email';
$mail->Body = 'This is a test message from PHPMailer';

try {
    $mail->send();
    ob_clean(); // 清空缓冲（如果开启了的话）
    http_response_code(200);
    exit(json_encode(["message"=>"Mails sent successfully!"]));
} catch (Exception $e) {
    ob_clean();
    http_response_code(500);
    exit(json_encode(["message"=>"Mails not sent!", "error"=>$mail->ErrorInfo]));
}

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