Laravel邮件图片Gmail不显示Outlook正常的兼容方案问询

针对你遇到的Base64图片在Gmail无法渲染、直接引用本地文件Outlook不显示的问题，除了Blob，还有两种更可靠的兼容方案：

方案1：嵌入邮件附件（CID引用） #

这是邮件客户端兼容性最优的方案之一，原理是将图片作为邮件的内嵌附件，通过Content-ID（CID）在模板中引用。Laravel邮件系统原生支持该方式，无需手动处理编码逻辑。

实现步骤： #

1. 在DealerApprovalEmail Mailable类中添加内嵌图片：

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
use App\Models\Dealer;

class DealerApprovalEmail extends Mailable
{
    use Queueable, SerializesModels;

    public $dealer;

    public function __construct(Dealer $dealer)
    {
        $this->dealer = $dealer;
    }

    public function build()
    {
        // 嵌入图片并指定CID标识为"email-icon"
        return $this->view('emails.dealer.approval')
                    ->with(['dealer' => $this->dealer])
                    ->embedData(file_get_contents(public_path('icon.png')), 'email-icon', 'image/png');
    }
}

2. 在Blade模板中通过CID引用图片：

<img src="{{ $message->embedData(file_get_contents(public_path('icon.png')), 'email-icon') }}" alt="品牌图标">

3. 简化控制器方法，移除Base64编码逻辑：

public function send_dealer_email(int $dealer_id)
{
    $dealer = Dealer::findOrFail($dealer_id);

    Mail::to('example@gmail.com')->send(new DealerApprovalEmail($dealer));

    return response([
        'message' => 'Email sent successfully'
    ]);
}

方案2：使用公开可访问的图片URL #

如果图片可以部署到公开服务器（比如Laravel的public目录、云存储），直接使用完整HTTPS URL引用图片，兼容性同样出色，且无需处理附件逻辑。

实现步骤： #

1. 确保图片处于公开可访问位置，比如public/icon.png，对应的公开URL为https://你的域名.com/icon.png。

2. 控制器中传递生成的公开URL到Mailable：

public function send_dealer_email(int $dealer_id)
{
    $dealer = Dealer::findOrFail($dealer_id);
    $image_url = url('icon.png'); // 自动生成完整HTTPS URL

    Mail::to('example@gmail.com')->send(new DealerApprovalEmail($dealer, $image_url));

    return response([
        'message' => 'Email sent successfully'
    ]);
}

3. 模板中直接使用该URL：

<img src="{{ $image_url }}" alt="品牌图标" style="display:block; border:none;">

注意事项： #

• 部分邮件客户端会默认屏蔽外部图片，需要用户手动开启，这是行业普遍规则，无法避免；
• 优先使用HTTPS协议的URL，避免被邮件客户端标记为不安全内容。

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