TP6的ExceptionHandler默认仅处理HTTP异常，需用set_exception_handler()全局接管；邮件告警须异步发信、配置键名严格匹配mail.php约定，且云服务器需注意SMTP端口封锁与IP限制。
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。
立即学习“PHP免费学习笔记（深入）”；
关键配置项（必须用这些 key）：
-
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），告警邮件不需要重试，失败就记日志，人来查
为什么线上收不到邮件但本地测试能发成功
核心差异在 DNS 解析和网络策略：云服务器（如阿里云、腾讯云）普遍屏蔽 25 端口，且部分 SMTP 服务商（如 QQ、163）会拒绝来自云主机 IP 的连接，判定为“群发风险”。这不是代码问题，是基础设施限制。
排查路径：
- 先在服务器上跑
telnet smtp.qq.com 587，看是否能连通（很多云厂商默认封 25/465/587） - 换企业邮箱（如腾讯企业邮、阿里云企业邮），它们对云服务器友好，且提供独立 SMTP 域名（如
smtp.exmail.qq.com） - 绝对不要用个人 Gmail/Outlook，它们对非谷歌/微软生态 IP 的发信限制极严
- 如果必须用 QQ 邮箱，确保服务器所在地与账号注册地一致（比如账号是广东注册，服务器也得在广东节点）
最易被忽略的一点：告警邮件的 subject 里别带 URL 或特殊符号，某些邮件网关会直接拦截，换成纯文本错误码更稳妥，比如 [PROD] Exception #50023。
