使用PHPMailer发送OTP验证码邮件失败：无报错收不到邮件求助

问题概述 #

开发密码重置功能时，通过PHPMailer向用户邮箱发送OTP验证码，但无法收到邮件且无任何报错；此前曾成功使用PHPMailer，怀疑前端jQuery存在问题，同时提交表单后表单值未清空、无提示弹窗，需排查解决。

现有代码 #

HTML代码 #

<div class="container">
  <div class="row justify-content-center">
    <div class="col-md-6">
      <div class="card mt-5">
        <div class="card-header">
          Reset Password
        </div>
        <div class="card-body">
          <form id="reset-password">
            <div class="form-group">
              <label for="email">Email</label>
              <input type="email" class="form-control" id="email" name="email" required>
            </div>
            <div class="form-group">
              <label for="new-password">New Password</label>
              <input type="password" class="form-control" id="new-password" name="new-password" required>
            </div>
            <div class="form-group">
              <label for="confirm-password">Confirm Password</label>
              <input type="password" class="form-control" id="confirm-password" name="confirm-password" required>
            </div>
            <button type="submit" class="btn btn-primary">Reset Password</button>
          </form>
        </div>
      </div>
    </div>
  </div>
</div>

jQuery代码 #

$(document).ready(function(){
    $("#reset-password").submit(function(event){
        event.preventDefault();
        var formData = $(this).serialize();
        $.ajax({
            url: "reset-password.php",
            type: "POST",
            data: formData,
            success: function(data){
                if(data == "success"){
                    alert("Password reset successfully.");
                    window.location.href = "login.php";
                }else if(data == "error"){
                    alert("Invalid email or OTP code.");
                }else if(data == "password_mismatch"){
                    alert("New password and confirm password do not match.");
                }else{
                    alert("Something went wrong. Please try again later.");
                }
            }
        });
    });
`});
;`

PHP代码（两段合并整理） #

<?php
extract($_POST);
$currentDir = __DIR__;
$phpMailerDir = $currentDir . '/../vendor_emails/phpmailer/phpmailer';

require_once $phpMailerDir . '/src/PHPMailer.php';
require_once $phpMailerDir . '/src/SMTP.php';
require_once $phpMailerDir . '/src/Exception.php';

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

$mail = new PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.webmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = 'gcobani.mkontwana@agielimitless.org.za';
$mail->Password = 'MkontwanaG';
$mail->setFrom('ggcobani@gmail.com', 'Gcobani Mkontwana');
$mail->addAddress($_POST["email"]);
$mail->Subject = 'Password Reset';

$otp = rand(100000, 999999);
$mail->Body = 'Your OTP code is: ' . $otp;

if (!$mail->send()) {
    echo 'Message could not be sent. Mailer Error: ' . $mail->ErrorInfo;
} else {
    // 未实现数据库更新逻辑
}
?>

问题排查与修复 #

1. 前端jQuery问题 #

错误点：

• 代码存在语法错误：末尾多余的和分号（});和最后的;`），导致提交事件无法正常绑定，无弹窗反馈。
• 缺少AJAX错误回调：请求失败时没有任何提示。
• 无表单清空逻辑：提交后表单值保留，影响用户体验。
• 未提前校验密码一致性：前端未判断新密码和确认密码是否匹配，增加后端压力。

修复后代码：

$(document).ready(function(){
    $("#reset-password").submit(function(event){
        event.preventDefault();
        const $form = $(this);
        const newPass = $("#new-password").val();
        const confirmPass = $("#confirm-password").val();

        // 前端先校验密码一致性
        if(newPass !== confirmPass){
            alert("新密码与确认密码不匹配");
            return;
        }

        var formData = $form.serialize();
        $.ajax({
            url: "reset-password.php",
            type: "POST",
            data: formData,
            success: function(data){
                const res = data.trim();
                if(res == "success"){
                    alert("OTP已发送至您的邮箱，请查收后完成重置");
                    $form[0].reset(); // 清空表单
                    // 可跳转至OTP验证页面，而非直接登录
                    // window.location.href = "verify-otp.php";
                }else if(res == "error"){
                    alert("无效邮箱或邮件发送失败，请重试");
                }else if(res == "password_mismatch"){
                    alert("新密码与确认密码不匹配");
                }else{
                    alert(res || "操作失败，请稍后重试");
                }
            },
            error: function(){
                alert("网络请求失败，请检查连接后重试");
            }
        });
    });
});

2. 后端PHP问题 #

错误点：

• SMTP配置错误：smtp.webmail.com并非通用SMTP服务器地址，需确认邮箱服务商的正确SMTP地址（例如企业邮箱通常为smtp.agielimitless.org.za）。
• 缺少加密设置：端口587需启用TLS加密，否则无法建立安全连接。
• 无调试模式：无法查看SMTP交互细节，难以定位邮件发送失败原因。
• 响应不规范：发送成功/失败时未输出前端预期的标识（如"success"/"error"），导致前端无法正确判断状态。
• 变量风险：使用extract($_POST)存在安全隐患，建议直接获取POST参数。
• 缺失数据库逻辑：生成OTP后未存入数据库，无法后续验证。

修复后代码：

<?php
// 直接获取POST参数，避免extract的安全风险
$email = $_POST['email'] ?? '';
$newPassword = $_POST['new-password'] ?? '';
$confirmPassword = $_POST['confirm-password'] ?? '';

// 先校验密码一致性
if($newPassword !== $confirmPassword){
    echo "password_mismatch";
    exit;
}

// 校验邮箱格式
if(!filter_var($email, FILTER_VALIDATE_EMAIL)){
    echo "error";
    exit;
}

$currentDir = __DIR__;
$phpMailerDir = $currentDir . '/../vendor_emails/phpmailer/phpmailer';

require_once $phpMailerDir . '/src/PHPMailer.php';
require_once $phpMailerDir . '/src/SMTP.php';
require_once $phpMailerDir . '/src/Exception.php';

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

$mail = new PHPMailer(true); // 启用异常处理，便于捕获错误

try {
    // SMTP配置
    $mail->isSMTP();
    $mail->Host = 'smtp.agielimitless.org.za'; // 替换为邮箱服务商的正确SMTP地址
    $mail->Port = 587;
    $mail->SMTPAuth = true;
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // 启用TLS加密
    $mail->Username = 'gcobani.mkontwana@agielimitless.org.za';
    $mail->Password = 'MkontwanaG';

    // 邮件内容
    $mail->setFrom('gcobani.mkontwana@agielimitless.org.za', 'Gcobani Mkontwana'); // 发件邮箱建议与SMTP账号一致，避免被拦截
    $mail->addAddress($email);
    $mail->Subject = '密码重置验证码';
    $otp = rand(100000, 999999);
    $mail->Body = "您的密码重置验证码为：{$otp}\n验证码15分钟内有效，请及时使用。";

    // 启用调试模式（开发环境用，生产环境注释）
    // $mail->SMTPDebug = SMTP::DEBUG_SERVER;

    $mail->send();

    // 将OTP存入数据库（示例，需根据实际表结构调整）
    // 假设数据库连接已建立，表名为password_resets，字段email, otp, created_at
    // $pdo = new PDO('mysql:host=localhost;dbname=your_db', 'user', 'pass');
    // $stmt = $pdo->prepare("INSERT INTO password_resets (email, otp, created_at) VALUES (?, ?, NOW()) ON DUPLICATE KEY UPDATE otp=?, created_at=NOW()");
    // $stmt->execute([$email, $otp, $otp]);

    echo "success";
} catch (Exception $e) {
    // 记录错误日志（生产环境）
    // file_put_contents('mail_error.log', date('Y-m-d H:i:s') . " - " . $e->getMessage() . "\n", FILE_APPEND);
    echo "error";
    // 开发环境可输出错误详情：echo $e->getMessage();
}
?>

3. 额外注意事项 #

• 邮箱发送限制：部分邮箱服务商限制SMTP发送频率，需确认账号是否被限制。
• 垃圾邮件拦截：OTP邮件可能被归类为垃圾邮件，建议让用户检查垃圾邮件箱。
• HTTPS环境：生产环境建议使用HTTPS，避免AJAX请求被拦截。
• 密码加密：最终存储密码时需使用password_hash()加密，不可明文存储。

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