Laravel 10模板邮件发送异常：HTML显示问题求助

一、HTML显示为代码的直接原因及修复 #

1. 不必要的HTML转义 #

在prepareTemplate方法中，你对$body使用了htmlentities，这会将HTML标签（如<div>）转换为实体字符（如<div>），导致邮件客户端将其识别为纯文本而非可渲染的HTML。

修复代码：
移除对$body的转义（如果$notification->Body包含HTML内容），仅保留对主题的转义（主题应为纯文本）：

public function prepareTemplate($subject, $body, $templateId)
{
    // 仅对纯文本主题转义，避免特殊字符破坏格式
    $subject = htmlspecialchars($subject, ENT_QUOTES, 'UTF-8');
    // 移除$body的htmlentities调用，保留原始HTML
    // $body = htmlentities($body, ENT_QUOTES, 'UTF-8');

    // 新增：处理模板不存在的情况
    $template = $this->templates::where('InternalID', $templateId)->first();
    if (!$template) {
        throw new \Exception("ID为{$templateId}的模板不存在");
    }

    $templateHeader = $template->Header;
    $templateFooter = $template->Footer;

    $templateBody = str_replace('{{ subject }}', $subject, $template->Body);
    $templateBody = str_replace('{{ body }}', $body, $templateBody);

    $completeTemplate = $templateHeader . $templateBody . $templateFooter;

    return $completeTemplate;
}

2. Blade模板自动转义 #

Laravel Blade的{{ }}语法会自动转义HTML内容，导致你的模板被当作文本输出。需要使用{!! !!}语法来渲染原始HTML。

修复视图文件：
在resources/views/mail/test-email.blade.php中修改为：

{!! $template !!}

二、异常处理优化 #

当前异常处理仅记录了通知对象，未记录错误详情，不利于调试。

优化代码：

public function SendMail($notification)
{
    $templateService = new TemplateService(new Templates);
    try {
        $template = $templateService->prepareTemplate($notification->Subject, $notification->Body, 1);
        Mail::to($notification->Contact)->send(new MyTestEmail($notification, $template));
    } catch (\Exception $e) {
        $this->updateNotificationService->UpdateTriedCount($notification);
        Log::error([
            'Failed Notification' => $notification,
            'Error Message' => $e->getMessage(),
            'Stack Trace' => $e->getTraceAsString()
        ]);
        return false;
    }
}

三、Laravel 10邮件发送最佳实践 #

1. 优先使用Blade模板而非字符串拼接 #

放弃手动拼接HTML字符串，直接用Blade模板管理邮件结构，代码更易维护且支持Blade语法：

{{-- resources/views/mail/bootstrap-simple-card.blade.php --}}
{!! $header !!}
<div class="card-content">
    <h2>{{ $subject }}</h2>
    {!! $body !!}
</div>
{!! $footer !!}

修改Mailable类：

public function content(): Content
{
    $template = $this->templates::where('InternalID', 1)->firstOrFail();
    return new Content(
        html: 'mail.bootstrap-simple-card',
        with: [
            'header' => $template->Header,
            'subject' => $this->notification->Subject,
            'body' => $this->notification->Body,
            'footer' => $template->Footer,
        ]
    );
}

2. 异步发送邮件 #

实现ShouldQueue接口，将邮件放入队列异步发送，避免阻塞请求：

class MyTestEmail extends Mailable implements ShouldQueue
{
    use Queueable, SerializesModels;
    // ... 现有代码
}

3. 输入数据验证 #

在发送前验证邮件地址、主题和内容的合法性：

use Illuminate\Support\Facades\Validator;

public function SendMail($notification)
{
    $validator = Validator::make($notification->toArray(), [
        'Contact' => 'required|email',
        'Subject' => 'required|string|max:255',
        'Body' => 'required|string',
    ]);

    if ($validator->fails()) {
        Log::error('无效的通知数据', $validator->errors()->toArray());
        return false;
    }

    // ... 后续发送逻辑
}

4. 使用测试工具预览邮件 #

开发阶段配置Mailtrap接收邮件，避免发送到真实用户：

# .env文件配置
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=你的Mailtrap用户名
MAIL_PASSWORD=你的Mailtrap密码
MAIL_ENCRYPTION=tls

5. 数据库模板支持Blade语法 #

若模板存储在数据库，可自定义视图加载器，让数据库模板支持Blade变量和指令：

// 在AppServiceProvider的boot方法中添加
View::addNamespace('db', function ($viewName) {
    $template = Templates::where('InternalID', $viewName)->firstOrFail();
    return $template->Body;
});

使用时直接引用：

public function content(): Content
{
    return new Content(
        html: 'db::1', // 1为模板ID
        with: [
            'subject' => $this->notification->Subject,
            'body' => $this->notification->Body,
        ]
    );
}

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