thinkphp 6 不内置邮件功能，必须 composer 安装 phpmailer/phpmailer 并手动配置；报 class 'phpmailer\phpmailer\phpmailer' not found 主因是残留手动加载文件冲突、autoload.php 未引入或命名空间大小写错误；smtp 凭据严禁硬编码，须统一抽至 config/mail.php，且 encryption 与端口严格匹配（ssl+465/tls+587），qq/163 等需用授权码并开启对应服务；connection timed out 多因云服务器封禁25端口或 dns/ssl 校验失败，非代码逻辑问题。
ThinkPHP 6 不内置邮件发送能力，必须手动集成 PHPMailer；用 topthink/think-mailer 扩展会报错或不兼容，别试——它只支持 TP5，TP6 已废弃。
为什么 Composer 引入 phpmailer/phpmailer 后还是报 Class 'PHPMailer\PHPMailer\PHPMailer' not found
常见原因是加载冲突或路径残留：
- 删掉项目里所有手写的
PHPMailerAutoload.php、class.phpmailer.php、class.smtp.php—— 这些和 Composer 自动加载机制互斥 - 确认入口文件（如
public/index.php）中已包含require __DIR__.'/../vendor/autoload.php';（TP6 默认有，但宝塔子目录部署或 Docker 构建时可能被覆盖） - 检查命名空间使用是否正确：必须用
use PHPMailer\PHPMailer\PHPMailer;，不是use phpmailer\phpmailer\phpmailer;（大小写敏感，尤其在 Linux 环境）
config/mail.php 里哪些配置项不能写死、为什么
SMTP 凭据一旦硬编码进服务类或控制器，就会随 Git 提交泄露——线上邮箱账号大概率当天被爆破群发垃圾邮件。
- 必须把配置抽到
config/mail.php（需手动创建），内容至少包含：host、port、username、password、from、encryption -
encryption值要严格匹配服务商要求：ssl对应端口 465（QQ 邮箱、163 邮箱）；tls对应端口 587（Gmail、Outlook）；填反了直接卡在SMTP connect() failed - QQ/163/网易邮箱必须用「授权码」而非登录密码，且需在邮箱后台单独开启 POP3/SMTP 服务——这个步骤跳过，90% 的认证失败都出在这
发邮件时卡住或报 Connection timed out 怎么快速定位
这不是 PHPMailer 写错了，而是网络或平台策略挡在了第一步。
- 阿里云/腾讯云轻量应用服务器默认封禁 25 端口，必须改用 465 或 587，并检查安全组是否放行 outbound 连接
- 国内服务器直连 Gmail/Outlook SMTP 容易被限流或 DNS 解析失败，优先换用腾讯企业邮箱（
smtp.exmail.qq.com）或网易邮箱大师（smtp.ym.163.com） - 临时关掉 ThinkPHP 的日志和缓存：在
config/log.php中设'level' => []，在config/cache.php中设'default' => 'null'，排除框架层干扰 - Docker 容器内 DNS 解析失败、或系统时区与 NTP 不同步，会导致 SSL 证书校验失败——这类问题无法靠改代码解决，得查容器
/etc/resolv.conf和宿主机ntpq -p输出
真正难调的不是“连不上”，而是“连上了却在某些环境（比如宝塔子目录 + HTTPS + 自签名证书）里随机失败”——这时候得抓包看 TLS 握手阶段哪一步断了，而不是反复改 $mail->SMTPOptions。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
