ThinkPHP 6邮件发送失败主因是SMTP配置未正确加载：必须将参数显式写入config/mail.php并用env()读取，.env变量不自动生效；需匹配加密方式与端口（如QQ邮箱用ssl+465），启用OpenSSL扩展，使用邮箱授权码而非登录密码，并确认云服务器端口放行。
如果您在ThinkPHP项目中尝试发送邮件但始终失败，则可能是由于邮件传输协议配置缺失或SMTP参数未正确加载。以下是针对ThinkPHP 6及主流版本配置邮件发送服务的多种可行方法：
一、通过config/mail.php显式配置SMTP参数
ThinkPHP 6默认不读取.env中的MAIL_*变量，必须将SMTP配置显式写入config/mail.php文件，并通过env()函数动态加载环境变量，否则所有配置均无效。
1、在项目根目录的config目录下创建mail.php文件（若不存在）。
2、在mail.php中返回如下数组结构，确保所有关键字段均使用env()读取：
立即学习“PHP免费学习笔记（深入）”；
3、确认.env文件中已定义对应变量，例如：MAIL_HOST=smtp.qq.com、MAIL_PORT=465、MAIL_ENCRYPTION=ssl、MAIL_USERNAME=test@qq.com、MAIL_PASSWORD=your_auth_code。
4、特别注意：QQ邮箱必须使用ssl+465，163邮箱推荐ssl+465或tls+587，加密方式与端口必须严格匹配。
二、手动集成PHPMailer并封装为服务类
ThinkPHP 6官方已废弃think-mail扩展，推荐直接通过Composer引入原生PHPMailer v6.9+，避免autoload冲突与兼容性问题，同时便于异常捕获与连接复用控制。
1、执行命令安装PHPMailer：composer require phpmailer/phpmailer。
2、删除项目中任何残留的手动加载文件（如class.phpmailer.php、PHPMailerAutoload.php），防止与Composer自动加载机制冲突。
3、在app/service/目录下新建PHPMailerService.php，构造函数中从config('mail')读取全部SMTP参数，禁止硬编码。
4、在app/provider.php中绑定服务接口与实现类，并声明为单例：return [\app\service\MailService::class => \app\service\PHPMailerService::class];，避免重复初始化导致SMTP连接异常。
三、使用think-mailer扩展快速启用
think-mailer是专为ThinkPHP设计的轻量级邮件扩展，基于Symfony Mailer，支持队列异步、模板渲染与多驱动切换，适合需快速上线且不自定义底层逻辑的场景。
1、执行命令安装扩展：composer require topthink/think-mailer。
2、从vendor/topthink/think-mailer/src/config/mail.php复制配置模板至项目config/mail.php，并按需修改host、port、encryption等字段。
3、在控制器中调用发送逻辑：Mail::to('user@example.com')->subject('验证')->html(' 内容
4、如需异步发送，结合think-queue与Redis，将邮件任务推入队列由后台进程消费，避免HTTP请求阻塞。
四、启用OpenSSL扩展并验证基础环境
PHPMailer与Symfony Mailer均依赖OpenSSL进行TLS/SSL握手，若扩展未启用，将直接报错“Unable to connect with TLS”或“Connection could not be established”，且无法进入认证阶段。
1、检查php.ini中是否启用openssl：extension=openssl（Linux/macOS）或extension=php_openssl.dll（Windows）。
2、确认PHP版本不低于8.0（Symfony Mailer要求）或7.4（PHPMailer v6.9最低要求）。
3、执行命令验证：php -m | grep openssl，输出应包含openssl。
4、若使用Docker或宝塔子目录部署，还需确认容器网络DNS解析正常，必要时在php.ini中设置openssl.cafile=/etc/ssl/certs/ca-certificates.crt以规避证书校验失败。
五、配置邮箱平台侧SMTP服务与授权码
无论使用何种PHP层方案，发件邮箱账户本身必须完成平台侧配置，否则即使代码与网络完全正确，认证仍会返回535错误。
1、登录QQ邮箱 → 设置 → 账户 → “POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务” → 开启SMTP服务。
2、点击“生成授权码”，完成手机验证后获取16位随机字符串，该字符串即为MAIL_PASSWORD值，不可使用邮箱登录密码。
3、登录163邮箱 → 设置 → POP3/SMTP/IMAP → 勾选“开启SMTP服务” → 获取客户端授权码（同样需手机验证）。
4、阿里云/腾讯云轻量应用服务器默认封禁25端口，务必使用465或587端口，并确认安全组放行对应outbound连接。
