Laravel异常告警用邮件还是短信

wen PHP项目 2026-07-04 303

本文目录导读：

Laravel异常告警用邮件还是短信

邮件告警：适合“信息详实”的非紧急场景
短信告警：适合“紧急”且“需要立即处理”的场景
现代替代方案：企业微信/钉钉/Slack Bot （强烈推荐）
最终推荐方案（结合生产实践）

对于 Laravel 应用的异常告警，选择邮件还是短信，通常取决于以下几个关键因素：实时性需求、成本、信息量以及受众。

核心结论：

推荐主用邮件：作为默认的详细告警渠道。
配合短信（或企业微信/钉钉/Slack）：作为“值班人”或“严重错误”的紧急通知渠道。

下面进行详细对比和具体实施方案。

邮件告警：适合“信息详实”的非紧急场景

优点：

信息量大：可以直接在邮件正文中展示完整的异常堆栈（Stack Trace）、Request 数据、用户信息、环境变量等，非常利于排查问题。
成本极低：发送邮件几乎没有成本，可以频繁发送。
易于存档检索：邮件可以作为错误日志的副本，方便后续检索。

缺点：

实时性差：邮件通常有几分钟到十几分钟的延迟，且容易被收入“垃圾箱”或者不被频繁查看。
容易麻木：如果每天收到几十封“已捕获的异常”邮件，团队很容易忽略真正致命的错误。

Laravel 实现方案：

Laravel 日志系统原生支持邮件频道，在 config/logging.php 中添加一个 mail channel：

// config/logging.php
'channels' => [
    // ... 其他渠道
    'mail' => [
        'driver' => 'mail',
        // 使用 Laravel 内置的 Mail 门面，需先配置好 mail 参数
        'via'    => \Monolog\Handler\NativeMailerHandler::class,
        'from'   => ['address' => 'noreply@example.com', 'name' => 'App Error'],
        'to'     => ['dev@example.com'], // 收件人
        'subject' => '【Laravel 应用】严重异常告警',
        'level'  => 'critical', // 只发送 critical 及以上级别
    ],
],

更推荐的做法是使用事件+通知（Event + Notification）在自定义异常处理中发送邮件：

// app/Exceptions/Handler.php
public function register(): void
{
    $this->reportable(function (Throwable $e) {
        // 只在生产环境且为特定级别时发送
        if (app()->environment('production') && $this->isCriticalException($e)) {
            // 发送邮件通知
            Notification::route('mail', 'dev@example.com')
                ->notify(new ExceptionNotification($e));
        }
    });
}

短信告警：适合“紧急”且“需要立即处理”的场景

优点：

实时性强：短信是推送的，通常能在几秒内送达。
高关注度：没有人会忽略一条短信，适用于系统宕机、支付失败、数据库连接失败等致命错误。

缺点：

成本高：每条短信几毛到几分钱，频繁发送成本可观。
信息量有限：短信只能展示非常简短的文本（70 个中文字符），无法展示复杂堆栈。
容易被打扰：如果在非工作时间收到大量非关键短信，体验很差。

Laravel 实现方案：

Laravel 没有内置短信驱动，需要使用第三方服务（如阿里云短信、腾讯云短信、Twilio 等）的 SDK。同样在 ExceptionHandler 中，判断错误级别后触发短信发送。

关键实践：

限流：同一错误在短时间内（如 5 分钟内）只发一次短信，避免短信轰炸（可以使用 Laravel Cache 或 RateLimiter）。
分级：只有 emergency 或 critical 级别的错误才发短信。
内容精简只包含：应用名称、错误类型、关键文件/行号、发生时间。 【XX系统】严重错误：数据库连接失败，位于 AppServiceProvider.php:45，2024-05-20 14:30:00。

现代替代方案：企业微信/钉钉/Slack Bot （强烈推荐）

对于大多数互联网团队,短信和邮件的中间态——即时通讯软件（IM）机器人告警，是性价比最高的选择。

实时性：接近短信（几秒内推送）。
成本：免费（仅需一个 Webhook 地址）。
信息量：可以发送 Markdown、卡片消息，包含完整堆栈。
易用性：团队可以创建单独的告警群，@指定成员。

Laravel 实现：

推荐使用 laravel-notification-channels 系列包。

钉钉：laravel-notification-channels/dingtalk
企业微信：overtrue/laravel-wechat 或自定义 HTTP 通知
Slack：Laravel 原生支持 Notification::route('slack', 'webhook_url')

示例（钉钉群机器人）：

// 在通知类中
use Illuminate\Notifications\Notification;
use NotificationChannels\DingTalk\DingTalkChannel;
use NotificationChannels\DingTalk\DingTalkMessage;
class ExceptionNotification extends Notification
{
    public function via($notifiable)
    {
        return [DingTalkChannel::class];
    }
    public function toDingTalk($notifiable)
    {
        return DingTalkMessage::create()
            ->title('生产环境异常告警')
            ->markdown("**错误信息：** {$this->exception->getMessage()}\n\n**文件：** {$this->exception->getFile()}:{$this->exception->getLine()}\n\n**时间：** ".now());
    }
}

最终推荐方案（结合生产实践）

错误级别	渠道	限流策略
`debug`/`info`/`notice`	不告警	记录日志即可	-
`warning`	不告警	记录日志，定期 review	-
`error`	邮件/IM群	详细堆栈	每天一封汇总邮件
`critical`	邮件 + IM群	详细堆栈 + @责任人	每小时限流一次
`emergency`	短信 + 邮件 + IM	短信：简短摘要邮件：完整细节	同一错误 5分钟内不重复