如何配置ThinkPHP应用的全局异常告警邮件_Exception捕获并触发SMTP通知-ThinkPHP-PHP中文网

tp6的exceptionhandler默认仅处理http异常，需用set_exception_handler()全局接管；邮件告警须异步发信、配置键名严格匹配mail.php约定，且云服务器需注意smtp端口封锁与ip限制。

如何配置thinkphp应用的全局异常告警邮件_exception捕获并触发smtp通知

ThinkPHP 6 的 `ExceptionHandler` 怎么接管所有未捕获异常

默认情况下，TP6 的 ExceptionHandler 只处理 HTTP 请求上下文中的异常，命令行（如 php think command）或队列任务里的异常不会走这里。要真正“全局”，必须手动在入口或基础命令类里补一层 set_exception_handler()，再把异常转发给 TP 的处理器。

实操建议：

在 public/index.php 底部加：

set_exception_handler(function($e) {
    \think\facade\Log::error('Uncaught exception: ' . $e->getMessage());
    // 手动触发邮件告警逻辑（见下节）
    send_alert_email($e);
});

队列任务需在每个 Job::handle() 内 try/catch + 显式调用告警函数，TP 不会自动包裹
注意：set_exception_handler() 不能和 register_shutdown_function() 混用，否则致命错误（如 Fatal error: Class 'xxx' not found）可能被吞掉

SMTP 邮件配置写在哪、哪些键名不能错

TP6 不读 .env 里的 MAIL_* 变量，必须显式写进 config/mail.php，且键名严格匹配框架约定——比如它认 host，不认 smtp_host；认 password，不认 app_password。

常见错误现象：发信无报错但收不到邮件，日志里只有 Connection could not be established with host smtp.qq.com，大概率是配置键名拼错或端口没开 TLS。

关键配置项（必须用这些 key）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

host：如 'smtp.qq.com'，不要带 ssl:// 前缀
port：QQ 邮箱用 587（STARTTLS），不是 465（旧 SSL）
username：完整邮箱地址，如 'alert@example.com'
password：SMTP 专用密码（QQ 邮箱叫“POP3/IMAP/SMTP 服务授权码”）
from 必须包含 address 和 name 两个子键，缺一不可

怎么在 `ExceptionHandler` 里安全发告警邮件而不阻塞响应

直接在 render() 或 report() 里调用 \think\facade\Mail::send() 会同步阻塞请求，一旦 SMTP 超时（比如网络抖动），用户等 30 秒才看到 500 页面。生产环境必须异步。

实操建议：

用 TP6 自带的 queue 驱动，把发信封装成 Job，例如：
```
dispatch(new SendAlertEmailJob($exception));
```
Job 内部用 try/catch 包住 Mail::send()，失败记录到日志，不抛出新异常（否则队列卡死）
避免在 report() 中发信——它可能被多次调用（如调试模式下），导致重复邮件
务必设置队列重试上限（如 maxTries=1），告警邮件不需要重试，失败就记日志，人来查