邮件客户端(如 Gmail)会自动折行长 HTML 行,导致 URL 被错误地插入 %20(空格编码),即使原始代码中无空格;根本原因是 MIME 行长度限制(约 1024 字符),需通过换行分隔或 Base64 编码解决。
邮件客户端(如 gmail)会自动折行长 html 行,导致 url 被错误地插入 `%20`(空格编码),即使原始代码中无空格;根本原因是 mime 行长度限制(约 1024 字符),需通过换行分隔或 base64 编码解决。
在 PHP 中使用 mail() 发送 HTML 邮件时,若 标签的 href 属性所在行过长(常见于拼接大量内联样式或嵌套 HTML),部分邮件服务(尤其是 Gmail)会强制按 RFC 2822 规范对超长行进行软折行(soft line break),并在断点处插入空格——该空格经 URL 编码后即表现为 %20,从而破坏链接完整性。例如 http://rfp.wabtec.com/production/apps/documen%20tControl 实际是 documentControl 被折成 documen + tControl,中间插入了空格。
✅ 正确解决方案
方案一:手动换行,避免超长单行(推荐)
将 $email_body 字符串中的 HTML 拆分为多行,用真实换行符 \n 替代字符串拼接符号 .,确保每行不超过 998 字符(RFC 建议安全上限)。PHP 会保留换行符,而邮件传输代理(MTA)不再强制折行:
$email_body = "<style type="text/css">
BODY {FONT-FAMILY: arial,helvetica,sans-serif,verdana; FONT-SIZE: 14px;}
.heading {FONT-FAMILY: arial,helvetica,sans-serif,verdana; FONT-SIZE: 16px; FONT-WEIGHT: bold;}
th {text-align: left; padding-right: 10px; padding-bottom:5px;}
td {padding-bottom:5px;}
</style><div>Hello</div><br><div>$body_one</div><br>
| File: | $name |
|---|---|
| Type: | $type |
| Description: | $description |
";
⚠️ 注意:不要用 . 连接多行字符串(如 "line1" . "line2"),否则 PHP 会合并为单行;直接使用多行字符串字面量(Heredoc 或普通多行字符串)更安全。
方案二:启用 Base64 编码(更健壮)
在邮件头中添加 Content-Transfer-Encoding: base64,并 Base64 编码整个 HTML 正文。这彻底规避行长度问题,且兼容性极佳:
$email_headers = "MIME-Version: 1.0\r\n" .
"Content-type: text/html; charset=utf-8\r\n" .
"Content-Transfer-Encoding: base64\r\n" .
"From: RFPC Document System \r\n" .
"Reply-To: RFPC Document System \r\n";
// Base64-encode the entire body
$email_body_encoded = base64_encode($email_body);
$email_send = @mail($email_to, $email_subject, $email_body_encoded, $email_headers);
✅ 优势:完全消除空格注入风险,支持 UTF-8,适配所有主流邮箱。
⚠️ 注意:charset 应设为 utf-8(而非 iso-8859-1),并确保 $email_body 已正确编码(如含中文需 mb_convert_encoding($email_body, 'UTF-8'))。
? 验证与调试建议
- 使用 Mailtrap 或本地 SMTP 测试环境捕获原始邮件源码,检查 Content-Transfer-Encoding 和实际行长度;
- 在浏览器中右键“查看网页源代码”,确认 的 URL 是否被意外截断或换行;
- 避免在 URL 中拼接变量时遗漏 urlencode() —— 虽然本例路径固定,但若 $file 等含空格/特殊字符,仍需 urlencode($file)。
综上,优先采用方案一(自然换行)快速修复;长期项目建议升级至方案二(Base64 编码)+ UTF-8 字符集,兼顾安全性与可维护性。











