PHP 8.1+ 中使用 mail() 发送多部分邮件时，若正文开头出现 --PHP-alt-xxx 边界标识，根本原因是换行符不合规（应统一用 \r\n 而非 \n），导致 MIME 结构被错误解析，边界行被误作普通文本写入正文。
php 8.1+ 中使用 mail() 发送多部分邮件时，若正文开头出现 --php-alt-xxx 边界标识，根本原因是换行符不合规（应统一用 \r\n 而非 \n），导致 mime 结构被错误解析，边界行被误作普通文本写入正文。
在 PHP 8.1 及更高版本中，mail() 函数对邮件头与正文的换行规范执行更严格——RFC 5322 明确要求所有邮件头字段与 MIME 部分之间必须使用 CRLF（\r\n）作为行终止符，而早期 PHP（如 5.6）对单 LF（\n）存在容错处理。升级后，若代码中混用 \n 构造多部分邮件体（尤其是 --boundary 行、Content-Type 行、空行等关键位置），MTA（如 sendmail/postfix）将无法正确识别 MIME 分段，进而把本该隐藏的边界标记（如 --PHP-alt-4de4a7c8...）当作纯文本内容原样输出到收件人邮箱正文顶部。
✅ 正确构造 multipart/alternative 邮件的关键修正
你提供的代码中，$body 数组使用 implode("\r\n", $body) 拼接，看似已用 \r\n，但隐患在于：MIME 规范要求每个头部字段后必须紧跟一个空行（即 \r\n\r\n），且各 MIME 部分之间的分隔行（如 --PHP-alt-xxx）本身也必须独占一行，并以 \r\n 结尾。若拼接逻辑遗漏空行或换行不一致，结构即失效。
以下是修复后的完整可运行示例：
<?php
$random_hash = md5(uniqid(time(), true));
$to = 'recipient@example.com';
$subject = 'HTML 邮件测试';
$message_plain = '这是纯文本版本的内容。';
$message_html = '<p>这是<strong>HTML 版本</strong>的内容。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>';
// ✅ 正确设置 headers（全部使用 \r\n 分隔，且不包含多余空格）
$headers = [
"From: webmaster@example.com",
"Reply-To: support@example.com",
"Content-Type: multipart/alternative; boundary=\"PHP-alt-$random_hash\"",
"MIME-Version: 1.0"
];
$headers_str = implode("\r\n", $headers) . "\r\n"; // 末尾加 \r\n 确保 headers 与 body 间有空行
// ✅ 正确构造 body：每个 MIME 部分严格遵循 [boundary]\r\n[headers]\r\n\r\n[content]\r\n
$body = [];
// --- Plain text part ---
$body[] = "--PHP-alt-$random_hash";
$body[] = "Content-Type: text/plain; charset=\"utf-8\"";
$body[] = "Content-Transfer-Encoding: 8bit";
$body[] = ""; // ← 关键：空行分隔 header 与 content（必须是 \r\n\r\n）
$body[] = $message_plain;
// --- HTML part ---
$body[] = "--PHP-alt-$random_hash";
$body[] = "Content-Type: text/html; charset=\"utf-8\"";
$body[] = "Content-Transfer-Encoding: 8bit";
$body[] = "";
$body[] = "<html><head><meta charset=\"utf-8\"><title>$subject</title></head><body>$message_html</body></html>";
// --- Final boundary (with trailing --) ---
$body[] = "--PHP-alt-$random_hash--";
// ✅ 最终拼接：全部使用 \r\n，且确保无 \n 混入
$body_str = implode("\r\n", $body) . "\r\n"; // 末尾 \r\n 保证完整性
// 发送
if (mail($to, $subject, $body_str, $headers_str)) {
echo "✅ 邮件发送成功（含 HTML/TEXT 双版本）";
} else {
error_log("❌ mail() 返回 false，请检查 MTA 日志");
}⚠️ 必须注意的 4 个关键点
-
换行符必须全栈统一为
\r\n：包括headers数组元素间、$body各行间、空行、边界行、结尾行——绝对禁止混用\n或\r； -
空行不可省略：每个 MIME 部分的头部与正文之间必须有且仅有一个
\r\n（即空行），这是 RFC 强制要求； -
边界字符串需全局一致：
headers中声明的boundary="..."必须与$body中所有--PHP-alt-xxx和--PHP-alt-xxx--完全匹配（含引号、大小写、连字符）； -
避免用户输入注入：
$random_hash应使用md5(uniqid())等安全方式生成，切勿拼接用户可控内容到boundary或headers，以防邮件头注入（Header Injection）漏洞。
? 排查建议（当问题仍存在时）
-
启用 PHP 错误日志：在
php.ini中设置log_errors = On+error_log = /var/log/php-mail.log，观察mail()调用是否触发警告； -
检查 MTA 日志：Linux 下查看
/var/log/mail.log或journalctl -u postfix，确认是否因格式错误被拒绝投递； -
临时改用 PHPMailer：若生产环境急需稳定，推荐切换至 PHPMailer（支持 SMTP + 自动 MIME 构建），规避底层
mail()的兼容性陷阱。
? 总结：PHP 8.1 并未“新增”
--PHP-alt-行为，而是收紧了对 RFC 合规性的校验。所谓“意外出现”，实为旧代码长期存在的 MIME 结构缺陷，在新版中暴露。坚持\r\n统一换行、严格空行分隔、边界精准匹配，即可彻底解决。
