Laravel添加邮件附件时Gmail应用端出现布局偏移问题

根因说明 #

该问题由Laravel依赖的邮件传输组件的默认换行机制触发：当发送带附件的multipart类型邮件时，组件会默认对HTML内容执行每76字符自动折行操作，如果换行位置刚好落在HTML标签内部、样式属性中间，Gmail移动端应用解析时会误生成多余空白节点，最终导致整体布局右移、左侧留存大量空白。

可落地修复方案 #

• 方案1：禁用邮件内容自动折行
  Laravel 8及以上版本可直接在config/mail.php配置文件中调整邮件编码参数，关闭自动折行：

  return [
      // 其他原有配置保持不变
      'mailers' => [
          'smtp' => [
              // 原有smtp配置（host、port、username等）不变
              'encoding' => '8bit',
              'preferred_charset' => [
                  'utf-8' => 'Q',
              ],
          ],
          // 其他邮件驱动配置同理添加上述两行参数
      ],
  ];
  

• 方案2：重置邮件模板根节点样式
  所有邮件Blade模板必须明确给html、body标签添加全局重置样式，避免Gmail默认样式干扰，且所有布局样式必须用inline内联写法，不要使用嵌入式<style>块：

  <!DOCTYPE html>
  <html style="width: 100%; margin: 0; padding: 0;">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
  </head>
  <body style="width: 100%; margin: 0; padding: 0; background-color: #ffffff;">
    <!-- 原有邮件内容代码 -->
  </body>
  </html>
  

• 方案3：旧版本Laravel手动设置编码
  对于Laravel 8以下的版本，可在发送邮件的回调中手动修改邮件实体的编码配置：

  Mail::send('emails.your-template', $data, function ($message) {
      $message->to('recipient@example.com')
          ->subject('邮件标题')
          ->attach(storage_path('app/public/your-attachment.pdf'));
      
      // 手动设置HTML内容编码为8bit，关闭自动折行
      $swiftMessage = $message->getSwiftMessage();
      $swiftMessage->setEncoding('8bit');
      $swiftMessage->getBody()->setEncoding('8bit');
  });
  

以上方案可单独使用也可组合使用，均可修复该场景下的布局异常问题。

内容的提问来源于stack exchange，提问作者Ali Abu Arab