thinkphp 6 邮件发送必须在 config/mail.php 中通过 env() 显式读取 smtp 参数才生效，.env 文件配置无效；需严格匹配加密方式（ssl+465 或 tls+587），qq/163 邮箱须用授权码并开启 smtp 服务。
如果您在ThinkPHP项目中无法成功发送邮件，则很可能是SMTP服务配置未正确生效。以下是针对不同ThinkPHP版本的多种SMTP服务配置方法，涵盖官方推荐路径与兼容性方案：
一、ThinkPHP 6 使用 config/mail.php 显式配置（官方推荐）
ThinkPHP 6 默认不读取 .env 中的 MAIL_* 变量，必须在 config/mail.php 中通过 env() 函数显式调用，否则所有 SMTP 参数均无效。该方式适配 symfony/mailer 底层，是 TP6.1+ 唯一稳定路径。
1、确认项目根目录下存在 config/mail.php 文件；若不存在，请手动创建。
2、在该文件中返回完整数组，确保 'host'、'port'、'username'、'password'、'encryption' 等字段全部使用 env() 读取。
3、严格匹配加密方式与端口：ssl + 465 或 tls + 587，混用将导致连接卡死且报错 Connection could not be established。
4、QQ 邮箱或 163 邮箱必须使用 授权码 而非登录密码，并在邮箱设置中开启 POP3/IMAP/SMTP 服务。
二、ThinkPHP 6 手动集成 PHPMailer v6.9+（兼容旧逻辑）
当项目依赖原有 PHPMailer 行为（如自定义异常处理、附件流式写入等），可绕过 symfony/mailer，直接引入原生 PHPMailer。此方式需规避自动加载冲突，适用于迁移遗留系统。
1、执行命令 composer require phpmailer/phpmailer:^6.9 安装最新稳定版。
2、删除项目中所有手写的 PHPMailerAutoload.php、class.phpmailer.php 等旧文件，防止命名空间冲突。
3、在 config/mail.php 中定义独立配置项（如 'phpmailer' => [...]），不与默认 'smtp' mailer 混用。
4、编写封装服务类，实例化 \PHPMailer\PHPMailer\PHPMailer，并显式设置 Host、Port、SMTPAuth、SMTPSecure、Username、Password。
5、确保发件人地址（From）与 Username 完全一致，例如 admin@yourdomain.com，否则部分企业邮箱会拦截。
三、ThinkPHP 5 使用 config.php 全局配置（历史兼容）
ThinkPHP 5 支持在 config.php 中直接定义 MAIL_* 常量，框架通过 C() 函数读取。该方式简洁但不适用于 TP6，仅用于维护老项目或快速验证。
1、打开 config/config.php，在 return 数组中添加 'email' 子数组。
2、填入 'host' => 'smtp.163.com'、'port' => 465、'smtp_secure' => 'ssl'、'user_name' => 'xxx@163.com'、'pass_word' => '授权码'。
3、确保 'smtp_auth' => true 已启用，否则认证流程跳过。
4、在控制器中调用自定义 sendMail() 函数时，必须使用 C('email.xxx') 获取配置，不可硬编码。
四、云服务器环境专项修正（端口与DNS）
阿里云、腾讯云等轻量应用服务器默认封禁 25 端口，且部分区域 DNS 解析缓慢，导致 SMTP 连接超时。此问题与代码无关，必须从基础设施层修正。
1、确认所用端口为 465（SSL）或 587（TLS），绝对避免使用 25 端口。
2、在云平台安全组中放行 outbound 方向的对应端口（非 inbound），并检查本地防火墙是否拦截。
3、测试 DNS 可达性：在服务器终端执行 telnet smtp.qq.com 465 或 nc -zv smtp.163.com 465，验证 TCP 层连通。
4、若 telnet 失败但 ping 通，说明是防火墙或运营商拦截；若两者皆失败，需检查 /etc/resolv.conf 中 DNS 是否配置为 114.114.114.114 或 8.8.8.8。
五、授权码与身份校验强制规范
所有主流邮箱服务商（QQ、163、腾讯企业邮箱）均已强制要求使用授权码替代登录密码，且对 From 地址、发信域名有强一致性校验。忽略该规范将直接触发 535 认证失败。
1、登录邮箱网页端 → 设置 → POP3/IMAP/SMTP → 开启对应服务并生成 客户端专用授权码。
2、复制授权码时务必检查末尾是否含空格或换行符，建议用 strlen() 校验长度（QQ 授权码为 16 位，163 为 16 位字母数字组合）。
3、MAIL_USERNAME 必须为完整邮箱地址，例如 admin@domain.com，不可省略 @ 及域名部分。
4、若使用自定义域名发信（如 admin@yourdomain.com），必须在该域名 DNS 中添加 SPF 记录，例如：v=spf1 include:smtp.exmail.qq.com ~all，否则邮件大概率进入垃圾箱或被拒收。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
