Laravel 7升级到9后嵌入图片被识别为附件如何解决？

核心原因 #

Laravel 9切换到Symfony Mailer后，内嵌图片默认的Content-Disposition可能被设置为attachment而非inline，或是邮件MIME结构的处理逻辑变化，导致客户端误判内嵌图片为独立附件。

具体修复方法 #

方法1：手动指定内嵌图片的Content-Disposition #

在邮件类的build方法中，使用attachData或attach时显式设置inline类型的disposition，同时指定唯一的CID（内容ID）：

public function build()
{
    $imagePath = public_path('images/email-logo.png');
    $imageData = file_get_contents($imagePath);
    $uniqueCid = 'email-logo@your-domain.com'; // 自定义唯一标识

    return $this->view('emails.notification')
        ->attachData($imageData, 'email-logo.png', [
            'mime' => 'image/png',
            'disposition' => 'inline',
            'content_id' => $uniqueCid,
        ])
        ->with(['logoCid' => $uniqueCid]);
}

然后在Blade视图中通过CID引用图片：

<img src="cid:{{ $logoCid }}" alt="品牌Logo">

方法2：规范使用embed方法 #

如果使用Laravel内置的embed方法，确保在视图中直接调用，且邮件类的build方法仅返回视图：

public function build()
{
    return $this->view('emails.welcome');
}

Blade视图内的调用方式：

<img src="{{ $message->embed(public_path('images/welcome-banner.png')) }}" alt="欢迎横幅">

注：若嵌入远程图片，建议先用file_get_contents获取资源内容，再通过embedData方法嵌入，避免远程资源加载异常导致MIME结构出错。

方法3：强制设置邮件MIME类型 #

部分邮件客户端对multipart/related类型的内嵌图片识别更友好，可在邮件类中手动指定：

public function build()
{
    $this->withSymfonyMessage(function ($message) {
        $message->getHeaders()->addTextHeader('Content-Type', 'multipart/related');
    });

    return $this->view('emails.invoice')
        ->embed(public_path('images/invoice-watermark.png'));
}

额外排查点 #

• 检查图片文件名是否包含特殊字符，避免客户端解析异常
• 测试不同邮件客户端（如Outlook、Gmail、Apple Mail），部分客户端对内嵌图片的识别逻辑存在差异
• 确认邮件中未同时添加真实独立附件，避免客户端统一显示回形针图标

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