PHP mail()函数移动端邮件格式异常、附件失效问题排查求助

这种跨客户端的邮件显示差异，多半是MIME邮件结构的细节没符合RFC标准——三星的邮件客户端对格式要求比桌面端严格得多。我之前帮朋友排查过类似问题，总结了几个最可能的触发点：

• 边界（Boundary）定义不规范
  多部分邮件（multipart）完全依赖边界字符串分隔HTML内容和附件，如果边界重复、格式不对，三星客户端就会直接把整个邮件当成纯文本渲染，包括你的代码和Base64编码内容。

  • 检查点：确保边界是唯一的（比如用uniqid('', true)生成），每个部分开头必须是--$boundary\r\n，结尾要加--$boundary--\r\n闭合，而且边界字符串不能在邮件内容里出现。
  • 示例代码：

    $boundary = '----=' . uniqid('', true);
    $headers .= "Content-Type: multipart/mixed; boundary=\"$boundary\"\r\n";
    // HTML部分开头
    $message .= "--$boundary\r\n";
    $message .= "Content-Type: text/html; charset=utf-8\r\n\r\n";
    $message .= $html_content . "\r\n";
    // 附件部分开头
    $message .= "--$boundary\r\n";
    // 结尾闭合
    $message .= "--$boundary--\r\n";
    

• 换行符未遵循RFC标准
  RFC要求邮件头和邮件内容的换行必须用\r\n（CRLF），而很多人写代码时习惯用\n（LF）。桌面端邮件客户端（比如Outlook、Gmail）对换行兼容较好，但三星客户端可能因为换行不正确，无法正确解析MIME结构，导致整个邮件乱码或显示代码。

  • 检查点：所有邮件头的分隔、邮件内容各部分的分隔，全部替换成\r\n，不要混用\n。

• Base64编码未做换行处理
  RFC规定Base64编码的内容每行不能超过76个字符，如果直接把编码后的长字符串塞进去，三星客户端可能无法识别这是附件的编码内容，而是当成普通文本显示。

  • 解决办法：用PHP的chunk_split()函数处理Base64编码后的内容，自动分割成符合要求的行：

    $encoded_file = chunk_split(base64_encode(file_get_contents($file_path)));
    

• Content-Type头格式错误
  比如没有正确声明multipart/mixed类型，或者缺少MIME-Version: 1.0头，或者HTML部分的Content-Type没指定charset=utf-8，这些都会导致三星客户端无法识别邮件的多部分结构。

  • 检查点：确保邮件头里先声明MIME-Version: 1.0\r\n，再声明Content-Type，并且正确引用边界：

    $headers = "MIME-Version: 1.0\r\n";
    $headers .= "Content-Type: multipart/mixed; boundary=\"$boundary\"\r\n";
    

• 邮件头顺序或格式不严谨
  有些客户端对邮件头的顺序有要求，比如From、To、Subject应该在MIME相关头之前，或者某些头缺少引号（比如边界字符串的引号），这些细节问题都可能触发三星客户端的解析错误。

  • 检查点：把基础头（From、To、Subject）放在最前面，MIME相关头（MIME-Version、Content-Type）放在后面；所有需要引号的参数（比如boundary值）都用双引号包裹，并且正确转义（如果用双引号字符串的话）。

你可以先从这几个点入手排查，尤其是边界和换行符的问题，这是最常见的触发点。

内容的提问来源于stack exchange，提问作者thecore7