使用PHPMailer添加附件与嵌入图片后Outlook附件消失问题求助

我之前也踩过PHPMailer和Outlook兼容的坑，这个问题十有八九是MIME消息结构不符合Outlook的严格解析规则导致的——Gmail会自动修复很多不规范的MIME格式，但Outlook的解析引擎对格式要求非常苛刻，一点点小问题就可能导致附件“消失”。下面是几个经过验证的解决方案：

1. 明确区分嵌入图片和附件的Content-Disposition #

嵌入图片必须指定为inline，附件必须指定为attachment，不要依赖PHPMailer的默认值：

• 嵌入图片时明确设置最后一个参数为inline：

  $mail->addEmbeddedImage(
      '/path/to/your/image.png', 
      'image_cid', // HTML中引用的cid
      'embedded-image.png', 
      'base64', 
      'image/png', 
      'inline' // 关键：标记为内嵌资源
  );
  

• 添加附件时明确指定attachment（如果PHPMailer默认不是的话）：

  $mail->addAttachment(
      '/path/to/your/file.pdf', 
      'attachment-document.pdf', 
      'base64', 
      'application/octet-stream', 
      'attachment' // 标记为附件
  );
  

2. 避免文件名冲突 #

如果嵌入图片和附件的文件名完全相同，Outlook会把它们识别为同一个资源，从而隐藏其中一个。确保嵌入图片和附件的文件名完全不同，比如内嵌图用header-logo-embedded.png，附件用quarterly-report.pdf。

3. 强制设置正确的MIME内容类型 #

有时候PHPMailer自动生成的Content-Type可能不符合Outlook的预期，你可以手动指定为multipart/related（这是包含内嵌资源和附件的标准类型）：

// 要在添加任何内容（HTML、图片、附件）之前设置
$mail->ContentType = 'multipart/related';

4. 调整内容添加顺序 #

Outlook对MIME部分的顺序很敏感，建议按照以下顺序操作：

1. 初始化PHPMailer并配置SMTP参数
2. 设置发件人、收件人
3. 开启HTML模式并设置邮件主题、HTML内容（确保内容里的cid和后续嵌入图片的cid一致）
4. 添加嵌入图片
5. 添加附件

5. 用极简代码排查问题 #

如果上面的方法都没解决，先写一个极简的测试代码（只保留核心逻辑），看看是否能复现问题。比如：

$mail = new PHPMailer();
$mail->isSMTP();
$mail->Host = $mailHost;
$mail->SMTPAuth = true;
$mail->Username = $yourMailUser;
$mail->Password = $yourMailPass;
$mail->SMTPSecure = 'tls';
$mail->Port = 587;

$mail->setFrom('sender@example.com', 'Test Sender');
$mail->addAddress('recipient@outlook.com', 'Test Recipient');

$mail->isHTML(true);
$mail->Subject = 'Embedded Image + Attachment Test';
$mail->Body = '<p>Check the embedded image: <img src="cid:test_image_cid"></p>';

// 添加内嵌图片
$mail->addEmbeddedImage('./test-image.png', 'test_image_cid', 'test-embedded.png', 'base64', 'image/png', 'inline');
// 添加附件
$mail->addAttachment('./test-document.pdf', 'test-attachment.pdf');

if (!$mail->send()) {
    echo 'Error: ' . $mail->ErrorInfo;
} else {
    echo 'Message sent successfully!';
}

如果这个极简代码能正常显示附件，说明你的原代码里有额外的干扰项（比如手动修改过MIME边界、重复添加内容等），可以逐步对比排查。

总的来说，Outlook对MIME格式的要求比Gmail严格得多，只要确保邮件的MIME结构完全符合RFC标准，问题基本都能解决。

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