使用PHPMailer发送密码重置链接时SMTP认证失败求助

针对你遇到的SMTP Error: Could not authenticate错误，可按以下步骤排查解决：

• 核对账号密码正确性
  确认邮箱账号、密码无输入错误，注意大小写与特殊字符。若使用Gmail、Outlook等第三方邮箱，需使用应用专用密码（前提是已开启两步验证），而非日常登录密码。

• 验证SMTP服务器配置
  确认服务器地址、端口、加密方式匹配：

  • Gmail：smtp.gmail.com，端口587（TLS）或465（SSL）
  • Outlook/Hotmail：smtp.office365.com，端口587（TLS）
  • QQ邮箱：smtp.qq.com，端口465（SSL）
    确保SMTPSecure设置与端口对应，比如587端口对应'tls'，465对应'ssl'，不可混用。

• 开启邮箱SMTP权限
  登录邮箱后台，确认已启用SMTP服务（例如QQ邮箱在「设置-账户」中开启「POP3/SMTP服务」）。部分邮箱会限制陌生设备登录，需在邮箱安全中心授权当前服务器的访问请求。

• 开启调试模式定位问题
  在PHPMailer代码中添加调试配置，获取更详细的错误日志：

  $mail->SMTPDebug = 2; // 开启详细调试，上线前记得关闭
  

  根据输出的日志信息，可精准定位认证失败的具体原因（如服务器拒绝连接、SSL证书问题等）。

• 检查服务器环境限制
  测试本地XAMPP环境是否封禁了SMTP端口（587、465），可通过终端执行命令验证：

  telnet smtp.gmail.com 587
  

  若连接失败，需关闭防火墙或配置代理允许SMTP连接。

参考配置示例 #

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

require '../vendor/autoload.php';

$mail = new PHPMailer(true);
try {
    // SMTP核心配置
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'your-email@gmail.com';
    $mail->Password = 'your-app-specific-password'; // 使用应用专用密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    // 收件人设置
    $mail->setFrom('your-email@gmail.com', '系统通知');
    $mail->addAddress('user@example.com');

    // 邮件内容
    $mail->isHTML(true);
    $mail->Subject = '密码重置链接';
    $mail->Body    = '<h2>点击下方链接重置密码</h2><a href="https://your-domain.com/reset?code=xxx">立即重置</a>';

    $mail->send();
    echo '邮件发送成功';
} catch (Exception $e) {
    echo "发送失败: {$mail->ErrorInfo}";
}

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