phpmailer 显示发送成功但邮件未抵达收件箱，通常并非代码执行失败，而是因 spf、dkim、dmarc 配置缺失、html 内容触发垃圾邮件过滤或发信域名信誉不足，导致邮件被拒收、静默丢弃或归入 spam 文件夹。
当 PHPMailer::Send() 返回 true 且 SMTP 服务器日志显示“已接受投递”，却收不到邮件时，问题几乎一定发生在发信链路后半段——即邮件虽经 SMTP 服务器发出，但在接收方（如 Gmail、Outlook、企业邮箱）的反垃圾系统中被拦截、延迟或静默丢弃。
? 关键排查方向（按优先级排序）
-
立即验证邮件信誉得分
将测试邮件发送至 mail-tester.com 提供的唯一测试邮箱（如 xxx@mail-tester.com），随后打开其报告页面。该工具会模拟主流邮箱服务商的过滤逻辑，给出 0–10 分评分，并逐条指出风险点，例如：- ❌ 缺少 SPF 记录（v=spf1 include:smtp.test.io ~all 未配置在 test.io 的 DNS 中）
- ❌ 无 DKIM 签名（PHPMailer 默认不启用，需手动配置私钥并发布公钥 DNS 记录）
- ❌ From 域名（@test.io）与 SMTP 认证域名（smtp.test.io）不一致，易触发 DMARC 失败
- ❌ HTML 内容含可疑链接、内联样式过多、缺少纯文本备选（$mail->AltBody = 'Plain text fallback...' 未设置）
-
修正基础配置硬伤
您当前代码存在多个高风险实践：- 端口 421 非标准 SMTP 端口：标准 SMTP 提交端口为 587（TLS）或 465（SSL）。421 通常是“服务不可用”响应码，若服务器强制监听此端口，需确认其 TLS/SSL 模式是否匹配（$mail->SMTPSecure = 'tls' 或 'ssl' 必须显式设置）；
- From 地址使用 Cloudflare 邮箱保护（data-cfemail）：该混淆机制会导致实际发信地址为空或无效，必须替换为真实、可验证的邮箱（如 noreply@test.io），且该域名需拥有完整 DNS 记录；
- 缺失错误详情输出：仅靠 if (!$mail->Send()) 无法定位问题。应启用调试并捕获异常：
$mail->SMTPDebug = 2; // 显示 SMTP 交互日志（生产环境请设为 0）
$mail->Debugoutput = function($str) { error_log($str); }; // 记录到日志而非页面-
增强邮件可信度的必备实践
// ✅ 强制设置纯文本备选内容（避免纯 HTML 被标记为垃圾邮件） $mail->AltBody = "Verification code: {$fourRandomDigit}. This is a one-time code."; // ✅ 使用与 SMTP 认证一致的发信域名（关键！） $mail->setFrom('noreply@test.io', 'Your App Name'); // test.io 必须是您控制的域名 // ✅ 启用 TLS 加密（若 SMTP 服务器支持 STARTTLS） $mail->SMTPSecure = 'tls'; $mail->Port = 587; // ✅ 添加消息头提升合法性（可选但推荐） $mail->addCustomHeader('X-Mailer', 'PHPMailer 6.x'); $mail->addCustomHeader('X-Priority', 'Normal');
⚠️ 特别注意：Cloudflare 邮箱混淆陷阱
- TXT 记录：test.io. IN TXT "v=spf1 include:smtp.test.io ~all"
- TXT 记录：default._domainkey.test.io. IN TXT "v=DKIM1; k=rsa; p=..."（需生成 DKIM 密钥对）
- TXT 记录：_dmarc.test.io. IN TXT "v=DMARC1; p=none; rua=mailto:postmaster@test.io"
✅ 总结：三步快速验证法
- 跑一次 mail-tester.com → 获取权威诊断报告；
- 检查 DNS 记录 → 使用 mxtoolbox.com 验证 SPF/DKIM/DMARC 是否生效；
- 改用真实邮箱 + 标准端口 + AltBody → 排除基础配置错误。
切勿依赖 echo "Email sent successfully" 作为交付依据——它只代表 PHPMailer 将邮件交给了 SMTP 服务器，而非最终送达。真正的“送达”需通过收件箱、垃圾邮件文件夹、邮件头分析（Received: 字段链）及第三方信誉平台交叉验证。
立即学习“PHP免费学习笔记（深入）”；
