Facade 静态调用只是代理，不参与生命周期控制；前置校验、模板预处理等必须在 Mail::send() 前完成，扩展应通过 transport 或事件监听，而非覆盖门面方法。
Facade 静态调用不等于真实静态，别在 Mail 门面里写业务逻辑
ThinkPHP 的 think\facade\Mail 是个门面（Facade），它本身没有发信能力，只是把调用转发给容器里绑定的邮件实例。很多人误以为可以直接在 Mail::send() 前后加日志、重试或模板预处理，结果发现这些逻辑在队列或命令行中不执行——因为门面只是代理，不参与生命周期控制。
实操建议：
- 所有前置校验（如邮箱格式、模板存在性）、语言变量注入、附件路径检查，必须在调用
Mail::send()之前完成 - 不要在门面类或它的子类里覆盖方法，想扩展行为应通过自定义 transport 或事件监听（如
Mailer::beforeSending） - 若需统一加 trace ID 或用户上下文，应在服务层封装一层
EmailService::sendWelcome($user)，而不是直接用Mail::to()->send()
环境变量驱动配置失效的典型原因
TP6 默认从 .env 读取 MAIL_HOST、MAIL_USERNAME 等变量，但 config/mail.php 若仍保留硬编码值（比如 'host' => 'smtp.qq.com'），就会覆盖环境变量——本地能发、线上 500 就是这个坑。
实操建议：
-
config/mail.php中只留'driver' => env('MAIL_DRIVER', 'smtp')，其余字段全设为null或删掉 - 确认
.env文件权限为 644，且没被 git 忽略；多环境时用.env.production而非.env.prod（TP 只认.env.*后缀） - 运行
php think clear:config清缓存，避免旧配置残留
PHP 8.1+ / OpenSSL 3.0 下 SMTP 认证失败不是密码错
报错类似 Connection failed: stream_socket_enable_crypto(): SSL operation failed 或 Failed to authenticate on SMTP server，实际是加密协议不匹配：OpenSSL 3.0 默认禁用弱协议，而很多老配置还写着 encryption=ssl + port=465，但 PHP 8.1+ 要求显式声明 tls 且端口必须是 587。
实操建议：
- 统一改用
ENCRYPTION=tls+PORT=587，哪怕服务商文档写“支持 SSL” - QQ 邮箱、163 邮箱必须用授权码，不能用登录密码；Gmail 已全面停用“允许不够安全的应用”选项
- 测试时临时开启
SMTPDebug = 2（在 transport 实例上设置），看握手阶段卡在哪一步
多语言邮件模板里 lang() 为空，不是框架 bug 是上下文缺失
邮件常在队列、命令行或定时任务中发送，此时没有 HTTP 请求生命周期，lang() 函数无法自动加载语言包，模板里写 {:lang('welcome_title')} 渲染出来就是空字符串，还不报错。
实操建议：
- 发送前主动加载语言包：
Lang::load(APP_PATH . 'lang/' . $user->lang . '.php') - 用
Lang::get('welcome_title')提前取值，作为变量传入模板：Mail::send('mail/welcome', ['title' => $title, 'body' => $body]) - 别依赖
Lang::setLocale()全局切换——队列进程是无状态的，下次发另一语言邮件时 locale 还是上次的值
关键点在于：Facade 只负责转发，真正的控制权在服务层和环境配置。最容易被忽略的是——邮件发送不是一次函数调用，而是跨上下文、跨环境、跨加密协议的链路，任何一环断开都静默失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
