如何在PHP邮件发送功能中显示错误信息

嘿，我来帮你搞定这个问题！你的代码里有两个关键问题导致看不到错误信息：一是用了错误抑制符@屏蔽了mail()函数的错误，二是直接跳转页面没机会展示错误详情。下面是具体的修复步骤和优化后的代码：

核心问题分析 #

1. 错误抑制符@：你在@mail()前加了@，这个符号会把mail()函数产生的所有警告、错误都隐藏起来，哪怕发送失败你也不知道具体原因。
2. 直接跳转页面：不管成功失败都立刻跳转到HTML页面，没有机会捕获和传递错误信息给用户。

修复方案 #

步骤1：开启完整的错误报告 #

先确保PHP能捕获并显示所有错误，把你的错误报告代码改成这样：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL); // 不要排除NOTICE，小细节可能导致大问题

步骤2：去掉错误抑制符，捕获错误信息 #

把@mail()的@去掉，然后用error_get_last()获取mail()函数的具体错误详情。同时用Session把错误信息传递到失败页面：

<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// 更安全的参数判断，确保必要字段存在
if(isset($_REQUEST['name'], $_REQUEST['email'], $_REQUEST['message'])) { 
    $TO = "test@gmail.com";
    $Name = $_REQUEST['name'];
    $EmailId = $_REQUEST['email'];
    $messages = $_REQUEST['message'];

    // FOR MAILING
    $FROM = "noreply@test.properties";
    $SUBJECT = "Enquiry From Website";
    // 邮件头必须用\r\n分隔，这是邮件协议的标准格式，避免解析错误
    $headers = "MIME-Version: 1.0\r\n" 
             . "Content-type: text/html; charset=iso-8859-1\r\n" 
             . "From: <".$FROM.">\r\n" 
             . "To: <".$TO.">\r\n" 
             . "Date: ".date("r")."\r\n";

    $message = " Name = ".$Name."<br /><br /> Email Address = ".$EmailId."<br /><br /> Comments = ".$messages."<br /><br /> ";

    // 去掉@，让错误能被正常捕获
    $mailSent = mail($TO, $SUBJECT, $message, $headers);

    if ($mailSent) {
        header("Location: success.html");
        exit; // 跳转后必须exit，防止后续代码继续执行
    } else {
        // 获取mail函数的错误详情
        $error = error_get_last();
        // 用Session存储错误信息，传递到失败页面
        session_start();
        $_SESSION['mail_error'] = $error['message'] ?? '邮件发送失败，但未获取到具体错误信息';
        header("Location: fail.php"); // 把fail.html改成fail.php才能解析PHP代码
        exit;
    }
}
?>

步骤3：在失败页面展示错误信息 #

把fail.html改成fail.php，这样可以读取Session里的错误信息并展示给用户：

<?php
session_start();
?>
<!DOCTYPE html>
<html>
<head>
    <title>发送失败</title>
</head>
<body>
    <h2>邮件发送失败</h2>
    <?php if (isset($_SESSION['mail_error'])): ?>
        <p><strong>错误详情：</strong><?php echo htmlspecialchars($_SESSION['mail_error']); ?></p>
        <?php unset($_SESSION['mail_error']); // 展示后清除Session，避免刷新重复显示 ?>
    <?php endif; ?>
    <p><a href="javascript:history.back()">返回重新发送</a></p>
</body>
</html>

额外调试建议 #

• 检查邮件头格式：邮件头的分隔符必须是\r\n，原代码里的普通换行可能导致邮件服务器解析失败。
• 快速调试技巧：测试时可以先不跳转，直接在当前页面输出错误信息，方便快速定位问题：

  if (!$mailSent) {
      $error = error_get_last();
      echo "发送失败：" . htmlspecialchars($error['message'] ?? '未知错误');
      exit;
  }
  

• 确认PHP邮件配置：如果是Linux服务器，检查php.ini里的sendmail_path是否正确；如果是Windows，检查SMTP相关配置是否有效。

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