Laravel集成PHPMailer发送带附件邮件时出现白屏显示服务器响应问题

核心原因 #

你遇到的白屏问题，根源是PHPMailer的SMTP_DEBUG_SERVER级别调试信息直接输出到了HTTP响应流中。不带附件时，SMTP交互内容少，调试信息可能没被注意到；带附件时，邮件传输过程中SMTP协议的交互日志（包括谷歌服务器的响应内容）会被直接打印到页面，干扰了原本要返回的JSON响应，导致出现短暂白屏。即便修改返回内容或不写返回语句，调试信息依然会输出，所以白屏问题持续存在。

解决方案 #

1. 关闭SMTP调试或重定向调试输出

在测试和生产环境，除非需要排查SMTP问题，否则建议直接关闭调试：

$mail->SMTPDebug = SMTP::DEBUG_OFF;

如果本地需要保留调试信息，不要让它输出到页面，而是写入Laravel日志：

use Psr\Log\LogLevel;

// 将调试信息定向到日志文件
$mail->Debugoutput = function($str, $level) {
    \Illuminate\Support\Facades\Log::log(LogLevel::DEBUG, $str);
};
$mail->SMTPDebug = SMTP::DEBUG_SERVER;

2. 改用Laravel标准文件处理方式

替换直接操作$_FILES的代码，使用Laravel Request对象封装的安全方法：

if ($request->hasFile('attachment')) {
    $attachment = $request->file('attachment');
    $mail->addAttachment($attachment->getRealPath(), $attachment->getClientOriginalName());
}

这样既符合Laravel开发规范，也能避免潜在的文件路径安全问题。

3. 确保响应无额外输出残留

如果调试信息清理后仍有白屏，可以在返回JSON前清空输出缓冲区，避免残留内容干扰：

$mail->send();
ob_clean(); // 清空输出缓冲区
return response()->json([
    'error' => false,
    'msg' => 'Email sent!'
]);

验证效果 #

修改后，带附件发送邮件时，调试信息会被写入日志（如果开启定向）或完全关闭，HTTP响应只会返回纯净的JSON，不会再出现包含谷歌服务器响应的白屏。

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