ThinkPHP 6 中应通过 app/provider.php 绑定 MailService 接口与 PHPMailerService 实现类，并声明为单例，避免重复初始化导致 SMTP 连接异常；配置需从 config/mail.php 加载，显式设置字符集与编码，捕获具体异常并结构化处理错误。
ThinkPHP 6 中如何注册全局邮件服务（MailService）
直接在 app/provider.php 里绑定接口和实现类，比在控制器里 new PHPMailer 干净得多。TP6 的容器支持接口绑定，这是依赖注入的基础——别再把邮件逻辑硬塞进控制器或模型里了。
常见错误是只写 bind 不写 singleton，导致每次 app()->make(MailService::class) 都新建实例，而 PHPMailer 内部有状态（比如 SMTP 连接、附件缓存），重复初始化可能触发连接复用失败或内存泄漏。
- 在
app/provider.php中添加：return [ \app\service\MailService::class => \app\service\PHPMailerService::class, ]; - 确保
PHPMailerService构造函数接收配置数组或从config('mail')读取，不要在类内部硬编码 SMTP 地址或密码 - 如果需要复用 SMTP 连接，
PHPMailerService应实现为单例（在app/service/MailService.php接口定义中不暴露构造细节，由工厂控制生命周期）
为什么不用 new PHPMailer() 而要走工厂模式
因为 PHPMailer 初始化成本高（SSL 上下文、SMTP 认证握手），且不同环境（开发/测试/生产）的配置差异大（比如本地用 mail()，线上走 SMTP，CI 环境干脆 mock）。硬编码创建方式会让这些切换变成改代码，而不是换配置。
工厂模式在这里不是炫技，是隔离变化点：发信逻辑不变，传输通道可插拔。你甚至可以加一个 LogMailTransport，开发时只记日志不真发，避免误触用户。
立即学习“PHP免费学习笔记（深入）”；
- 工厂类（如
MailFactory）应只负责返回符合MailService接口的实例，不做业务逻辑 - 避免在工厂里做条件判断选实例（如
if (env('APP_ENV') === 'test') return new FakeMail();），这会污染工厂职责；应该用容器绑定配合环境配置驱动 -
PHPMailer的isSMTP()/isSendmail()/isMail()是互斥开关，工厂必须确保只调一次，否则行为未定义
PHPMailerService 必须处理的三个异常场景
邮件发送失败往往不是代码错，而是网络、认证或内容被拒。不提前兜住，整个请求就崩成 500，用户看到白屏，日志里只有 SMTP Error: Could not authenticate. 这种信息，根本没法定位是密码过期还是账号被锁。
- 捕获
PHPMailer\PHPMailer\Exception，而不是Exception，否则会漏掉SMTPAuthenticationError等子类 - 对
$mail->send() === false的情况，必须调用$mail->getErrorInfo()拿结构化错误，不能只 echo$mail->ErrorInfo—— 后者含敏感信息（如完整 SMTP 响应），不能直接输出或记录明文 - 附件路径不存在、编码不合法（如中文文件名没用
utf8_encode()）、收件人格式错误（如user@）都会在send()前抛异常，得在send()外层 try，不能只包 send 本身
配置项怎么映射到 PHPMailer 实例（config/mail.php 关键字段）
TP6 默认没有 mail.php，得自己建。字段命名尽量贴近 PHPMailer 原生属性，减少转换层——多一层数组 key 映射，就多一个出错可能。
-
'host' => 'smtp.qq.com'→ 直接传给$mail->Host，别写成'smtp_host'再二次解析 -
'auth' => true控制是否调$mail->SMTPAuth = true，同时检查'username'和'password'是否非空，否则报错提示而非静默忽略 -
'secure' => 'ssl'对应$mail->SMTPSecure，但注意：PHPMailer 6.9+ 已弃用'tls'以外的值，'ssl'实际走的是stream_socket_enable_crypto的 SSLv23，兼容性差；建议统一用'tls'+ 端口 587 -
'debug' => 0生产环境必须为 0，设成 2 会把 SMTP 流水日志打到响应体，API 接口直接返回乱码
最常被忽略的是字符集和编码设置：$mail->CharSet = 'UTF-8' 和 $mail->Encoding = 'base64' 必须显式指定，否则中文主题、正文或附件名在 Outlook 里大概率显示为问号。这不是 bug，是 PHPMailer 的默认行为。
