PHP mail()无附件邮件空白及PHPMailer测试HTTP ERROR问题排查

浏览器显示的HTTP ERROR通常是500内部服务器错误，大概率是脚本执行时触发了致命错误，比如文件找不到、类不存在或者PHP版本不兼容。下面是一步步的排查和修复方案：

1. 检查文件路径和依赖加载 #

你的测试脚本只加载了Exception.php，但PHPMailer需要至少三个核心文件：PHPMailer.php、Exception.php、SMTP.php。假设你的文件夹结构是：

网站根目录/
├─ mailer-test.php
└─ php-mailer/
   └─ src/
      ├─ PHPMailer.php
      ├─ Exception.php
      └─ SMTP.php

修改require_once部分，加载所有必要文件：

require_once "php-mailer/src/Exception.php";
require_once "php-mailer/src/PHPMailer.php";
require_once "php-mailer/src/SMTP.php";

2. 查看PHP错误日志 #

500错误的具体原因需要看服务器的PHP错误日志，通常可以在：

• 主机控制面板（如cPanel）的“错误日志”里查看；
• 网站根目录下的error_log文件；
• 服务器系统日志（如/var/log/apache2/error.log或/var/log/nginx/error.log，取决于你的Web服务器）。

日志会明确告诉你是“找不到类”“文件不存在”还是“PHP版本过低”等问题。

3. 确保PHP版本兼容 #

PHPMailer 6.x要求PHP 5.5及以上版本，如果你的服务器PHP版本低于这个，会触发致命错误。可以在脚本开头添加phpinfo();查看版本，或者联系主机提供商升级PHP。

4. 添加SMTP配置（关键！） #

默认情况下，PHPMailer会尝试使用服务器的mail()函数，但很多共享主机的mail()配置有问题，建议明确配置SMTP（可以用主机提供的邮件服务器，或者第三方如Gmail/Outlook）。比如添加以下配置：

// 配置SMTP（根据你的主机信息修改）
$mail->isSMTP();
$mail->Host = 'smtp.yourhost.com'; // 你的主机SMTP地址，比如smtp.cpanel.net
$mail->SMTPAuth = true;
$mail->Username = 'me@mydomain.com'; // 你的发件人邮箱
$mail->Password = 'your_email_password'; // 邮箱密码（Gmail需要用APP密码）
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // 加密方式：STARTTLS或SSL
$mail->Port = 587; // 对应端口：587是STARTTLS，465是SSL

5. 检查文件权限 #

确保php-mailer文件夹和里面的文件权限正确（通常是755文件夹，644文件），避免PHP无法读取文件。

修复后的完整测试脚本 #

<?php 
use PHPMailer\PHPMailer\PHPMailer; 
use PHPMailer\PHPMailer\Exception; 

// 加载所有必要的PHPMailer文件
require_once "php-mailer/src/Exception.php";
require_once "php-mailer/src/PHPMailer.php";
require_once "php-mailer/src/SMTP.php";

try {
    //PHPMailer对象 
    $mail = new PHPMailer(true); 

    // 配置SMTP（根据你的主机信息修改）
    $mail->isSMTP();
    $mail->Host = 'smtp.yourhost.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'me@mydomain.com';
    $mail->Password = 'your_email_password';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    //发件人邮箱及名称 
    $mail->From = "me@mydomain.com"; 
    $mail->FromName = "Full Name"; 

    //收件人邮箱 
    $mail->addAddress("recipient@somedomain.com"); 

    //回复地址 
    $mail->addReplyTo("me@mydomain.com", "Reply"); 

    //发送HTML邮件 
    $mail->isHTML(true); 
    $mail->Subject = "PHPMailer Test Subject"; 
    $mail->Body = "<i>Mail body in HTML - test successful!</i>"; 
    $mail->AltBody = "This is the plain text version of the email content"; 

    $mail->send(); 
    echo "Message has been sent successfully"; 
} catch (Exception $e) { 
    echo "Mailer Error: " . $mail->ErrorInfo; 
} 
?>

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