必须使用邮箱平台生成的授权码而非登录密码，且username需与from.address完全一致、格式规范、未被注释或覆盖。
如果您在ThinkPHP项目中配置邮件功能时无法完成身份认证，很可能是邮件用户名未正确设置或与平台策略不匹配。以下是解决此问题的步骤：
一、确认邮箱平台SMTP服务已启用并获取授权码
邮件用户名必须对应已开通SMTP服务的邮箱账号，且密码字段须填写平台生成的「授权码」而非登录密码。QQ邮箱和163邮箱均强制要求使用授权码进行SMTP认证。
1、登录QQ邮箱网页版，进入「设置」→「账户」→「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务」。
2、向下滚动找到「POP3/SMTP服务」，点击「开启」，按提示发送短信或验证身份后获取授权码。
3、登录163邮箱网页版，进入「设置」→「POP3/SMTP/IMAP」→「开启SMTP服务」，点击「客户端授权码」生成并记录该授权码。
4、关键提示：授权码需严格区分大小写，且仅在首次生成时完整显示一次；若遗忘，必须重置获取新码。
二、在config/mail.php中显式配置username字段
ThinkPHP 6.x 不读取 .env 中未被 mail.php 主动调用的 MAIL_USERNAME 变量，必须确保 username 值通过 env() 函数注入或直接赋值，否则配置无效。
1、打开项目根目录下的 config/mail.php 文件。
2、在 smtp 配置块内，确认存在 'username' => env('MAIL_USERNAME', '') 行，且该行未被注释。
3、若采用硬编码方式（仅限开发环境），可临时替换为 'username' => 'yourname@qq.com'。
4、关键提示：username 必须与 from.address 完全一致；例如 from.address 为 test@163.com，则 username 也必须为 test@163.com。
三、检查.env文件中MAIL_USERNAME格式与可见性
.env 文件中的 MAIL_USERNAME 必须为纯文本格式，不得含空格、引号、中文字符或不可见控制符，否则 env() 解析失败会导致 username 为空字符串。
1、用纯文本编辑器（如 VS Code、Notepad++）打开 .env 文件。
2、定位到 MAIL_USERNAME 行，确认其形如 MAIL_USERNAME=contact@example.com，无前后空格，无单/双引号包裹。
3、检查该行是否被 # 注释符屏蔽，若有则删除 # 符号。
4、关键提示：.env 文件权限应设为 644，禁止设为 777 或由 Web 用户以外的用户写入，防止凭据泄露。
四、验证用户名在PHPMailer实例中是否被正确传递
即使配置文件无误，若封装层代码绕过配置直接构造 PHPMailer 实例，username 可能被覆盖或遗漏，需逐层检查调用链。
1、搜索项目中所有 new \PHPMailer\PHPMailer\PHPMailer() 或 $mail->Username = ... 的代码位置。
2、确认未在控制器或服务类中硬编码 $mail->Username = 'xxx'，该行为会覆盖 config/mail.php 设置。
3、若使用自定义 sendmail() 函数，检查其内部是否调用 env('mail.username') 或 config('mail.smtp.username') 获取值。
4、关键提示：在调试模式下临时添加 var_dump(env('MAIL_USERNAME')); exit; 到邮件发送入口，可直观察验变量是否被正确读取。
五、适配不同邮箱平台的用户名命名规范
部分企业邮箱或国际服务商对 username 格式有额外限制，例如要求包含域名后缀或禁用别名，错误格式将导致 535 认证失败。
1、QQ邮箱：必须使用完整邮箱地址（如 123456789@qq.com），不可省略 @qq.com。
2、163邮箱：必须使用完整邮箱地址（如 abc@163.com），不可使用别名（如 abc+test@163.com）。
3、腾讯企业邮箱：必须使用 exmail.qq.com 域名后缀的账号（如 user@exmail.qq.com），不可用普通 QQ 号。
4、关键提示：若使用子账户或部门邮箱，务必以主管理员后台分配的完整邮箱为准，而非个人常用别名。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
