PHPMailer SMTP发送失败主因是认证失败或端口/加密协议不匹配；需用应用专用密码、确保Username与setFrom一致、正确配置Port（587配TLS，465配SSL）并启用openssl扩展。
PHPMailer 连接 SMTP 发送邮件失败的常见报错
直接调用 mail() 函数在大多数生产环境会失败，因为本地 sendmail 未配置或被屏蔽。而用 PHPMailer 时最常遇到的是：SMTP Error: Could not authenticate.、Connection failed 或 535 Authentication failed —— 这些基本都指向认证参数错误或 SMTP 端口/加密方式不匹配。
关键点：Gmail、Outlook、QQ 邮箱等主流服务商默认禁用“密码登录”，必须用应用专用密码（App Password）或开启 SMTP 授权；同时必须核对端口与加密协议是否一致（例如 Gmail 的 smtp.gmail.com 要配 587 + TLS，不是 465 + SSL）。
- QQ 邮箱需在邮箱设置 → 账户 → “POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务” 开启 SMTP，并生成授权码（非账户密码）
- Gmail 需启用“两步验证”后，在 Google 账户安全设置里生成 App Password，且账户不能开启“安全性较低的应用访问权限”（该选项已废弃）
- 使用
$mail->isSMTP()后，必须显式设置$mail->Host、$mail->Port、$mail->SMTPAuth和$mail->SMTPSecure
PHPMailer 初始化与基础配置要点
别跳过 use PHPMailer\PHPMailer\PHPMailer; 和自动加载（推荐用 Composer 安装），否则会报 Class 'PHPMailer' not found。初始化后务必关闭调试输出（$mail->SMTPDebug = 0;），否则可能暴露敏感信息或破坏 HTTP 响应头。
以下是最小可行配置组合（以 QQ 邮箱为例）：
立即学习“PHP免费学习笔记（深入）”；
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.qq.com';
$mail->SMTPAuth = true;
$mail->Username = 'your@qq.com';
$mail->Password = 'your_app_password'; // 不是登录密码
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port = 587;
$mail->setFrom('your@qq.com', 'Your Name');
$mail->addAddress('to@example.com');
$mail->isHTML(true);
$mail->Subject = 'Test';
$mail->Body = '<p>Hello</p>';
$mail->send();
-
PHPMailer::ENCRYPTION_STARTTLS对应端口 587；若用 465，则改用PHPMailer::ENCRYPTION_SMTPS -
$mail->Password必须是应用专用密码（QQ/Gmail/Outlook 均如此），明文密码几乎必失败 - 发件人邮箱（
setFrom）必须与Username一致，否则部分服务商拒信
发送失败时怎么快速定位问题
把 $mail->SMTPDebug = 2; 临时打开，再运行，终端或页面会输出完整的 SMTP 交互日志（含服务器返回码）。重点看最后几行：比如出现 535 5.7.8 Error: authentication failed 就说明账号/密码错；出现 Connection timed out 则可能是防火墙、端口被封或 Host 写错。
- 检查 PHP 是否启用了
openssl扩展（extension=openssl在php.ini中）—— 没它，TLS/SSL 握手直接失败 - 确认服务器时间是否准确（误差超过 15 分钟会导致 Gmail 认证拒绝）
- 如果用共享主机（如 cPanel），部分服务商禁止外发 SMTP，只能用本机
mail()或其封装接口 - 测试时先用
var_dump($mail->ErrorInfo);打印错误，比靠猜快得多
中文收件人、主题乱码或被当垃圾邮件
乱码主因是没设字符集；进垃圾箱则多因缺少 SPF/DKIM 记录或发件域名与 SMTP 域名不一致。PHPMailer 默认用 UTF-8，但必须显式声明：
$mail->CharSet = 'UTF-8';
$mail->Subject = '=?UTF-8?B?'.base64_encode('中文标题').'?=';
不过更稳妥的做法是直接调用 $mail->Subject = '中文标题'; —— 新版 PHPMailer（6.8+）已自动处理编码。真正容易被忽略的是发件人地址：
- 用
setFrom('noreply@yourdomain.com')比用xxx@gmail.com更可信，前提是 yourdomain.com 已配置 SPF 记录（如v=spf1 include:_spf.google.com ~all） - 避免主题含“免费”“中奖”“ urgent ”等敏感词；正文别全是大段链接或图片
- 首次发送建议先发给自己和同事邮箱，检查原始邮件头（Gmail 点右上角「显示原始邮件」），确认
Return-Path和Authentication-Results字段是否正常
SMTP 认证本身不难，难的是每个服务商的细节差异和环境约束——花 10 分钟查清目标邮箱的专用密码生成路径和端口规则，比反复试错快得多。
