PHP 8.1升级后，使用mail()发送多部分邮件时，--PHP-alt-xxx边界标识错误地显示在收件人邮件正文开头，本质是因换行符不规范（误用\n\n而非\r\n）导致MIME结构解析失败。本文详解成因、修复步骤及安全实践。
php 8.1升级后，使用mail()发送多部分邮件时，--php-alt-xxx边界标识错误地显示在收件人邮件正文开头，本质是因换行符不规范（误用\n\n而非\r\n）导致mime结构解析失败。本文详解成因、修复步骤及安全实践。
PHP mail() 函数本身不生成 --PHP-alt- 这类边界字符串——它完全由开发者手动构造的 MIME 多部分（multipart/alternative）邮件体所定义。你代码中显式写入了：
$body[] = "--PHP-alt-$random_hash"; $body[] = "Content-Type: text/plain; charset=\"utf-8\""; $body[] = "Content-Transfer-Encoding: 8bit"; $body[] = ""; // ← 空行分隔头与正文 $body[] = "$message";
问题核心在于：PHP 8.1 严格遵循 RFC 2822 邮件协议，要求所有头部字段与段落间必须使用 CRLF（\r\n）作为行终止符；而旧版 PHP（如 5.6）对换行符兼容性更强，允许仅用 LF（\n）甚至混合使用。当你用 implode("\n", $body) 拼接邮件体时，实际生成的是 \n 分隔的文本，导致：
- 邮件客户端无法正确识别
--PHP-alt-...为边界分隔符； - 反而将其当作普通纯文本内容渲染到邮件正文中；
- 同时，
Content-Type: multipart/alternative声明虽存在，但因结构破损，客户端降级为显示原始 MIME 源码。
✅ 正确修复方式：统一使用 \r\n 拼接所有邮件内容（含 headers 和 body）
// ✅ 正确：headers 与 body 均使用 \r\n
$headers = [
"From: $from",
"Reply-To: $fromemail",
"Content-Type: multipart/alternative; boundary=\"PHP-alt-$random_hash\"",
"MIME-Version: 1.0"
];
$body = [
"--PHP-alt-$random_hash",
"Content-Type: text/plain; charset=\"utf-8\"",
"Content-Transfer-Encoding: 8bit",
"", // 空行（仍为 \r\n）
$message,
"",
"--PHP-alt-$random_hash",
"Content-Type: text/html; charset=\"utf-8\"",
"Content-Transfer-Encoding: 8bit",
"",
"<html><head><meta charset=\"utf-8\"><title>$subject</title></head><body>$message</body></html>",
"",
"--PHP-alt-$random_hash--"
];
$success = mail(
$email,
$subject,
implode("\r\n", $body), // ← 关键：必须是 \r\n
implode("\r\n", $headers) // ← 关键：必须是 \r\n
);⚠️ 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
-
禁止直接拼接用户输入：
$from、$fromemail、$subject、$message若含\r或\n，将引发邮件头注入（Header Injection），被用于伪造发件人或注入恶意头字段。务必过滤：$subject = preg_replace('/[\r\n]/', '', $subject); // 移除换行 $fromemail = filter_var($fromemail, FILTER_SANITIZE_EMAIL); -
避免手写 MIME 的长期风险：
mail()不验证 MIME 结构，无错误反馈，调试困难。生产环境强烈推荐改用 PHPMailer 或 Symfony Mailer，它们自动处理边界、编码、HTML/Plain 双版本、附件及 SMTP 认证。 -
PHP 8.1+ 的 sendmail_path 兼容性：确保
php.ini中sendmail_path以-t -i结尾（如/usr/sbin/sendmail -t -i），否则-t（读取 header 中的 To/Cc）可能失效，导致投递异常。
? 快速验证是否修复：
发送测试邮件后，查看原始邮件源码（Gmail → 点击右上角「⋮」→「显示原始邮件」），确认：
- 所有行以
CRLF（即显示为^M或换行正常）结尾； -
--PHP-alt-xxx行前后均有空行（\r\n\r\n）； - HTML 和 Plain 文本段落被正确包裹在边界之间，且末尾有
--PHP-alt-xxx--。
掌握换行符规范是 PHP 邮件开发的底层基石——一次修正，永久规避 PHP 升级带来的 MIME 解析故障。
