PHPMailer未修改凭据却出现SMTP认证失败问题咨询

PHPMailer 6.0.5版本过低是本次故障的核心诱因之一，按以下优先级排查修复即可：

1. 版本与配置顺序修复（最高优先级） #

• 微软已对Office365 SMTP服务强制要求TLS 1.2及以上加密协议，同时更新了SMTP认证握手逻辑。2018年发布的PHPMailer 6.0.5内置的TLS适配、认证交互逻辑均不匹配当前服务端规则，即便账号密码完全正确也会触发认证失败报错，必须先升级到6.5及以上稳定版本。
• 现有代码存在配置顺序错误：你在写完Host、端口、认证参数后才调用$mail->isSMTP()，低版本PHPMailer中该方法会重置SMTP实例，导致已配置的认证参数丢失，直接触发认证失败。
• 修正后的基础配置片段如下：

// These must be at the top of your script, not inside a function
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

function tep_htmlmail($to_name, $to_email_address, $email_subject, $email_text, $from_email_name, $from_email_address) {
    // Instantiation and passing `true` enables exceptions
    $mail = new PHPMailer(true);
    
    // Server settings：必须先调用isSMTP()，再配置所有SMTP相关参数
    $mail->isSMTP();
    //$mail->SMTPDebug = SMTP::DEBUG_SERVER;  // 调试时开启可查看完整SMTP交互日志，定位具体报错节点
    $mail->Host       = 'smtp.office365.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'email@mysite.com';
    $mail->Password   = 'MyPassword';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port       = 587;

    // Recipients
    $mail->setFrom($from_email_address, $from_email_name);
    $mail->addReplyTo($from_email_address, $from_email_name);
    // 后续收件人、邮件正文、附件等配置保持原有逻辑即可

2. 升级后仍报错的排查项 #

• 检查账号SMTP权限：进入Microsoft 365管理中心，找到对应用户的「邮件-管理电子邮件应用」配置，确认「已验证的SMTP」选项为勾选状态，租户开启安全默认值时该选项会被默认关闭。
• 检查多因素认证状态：如果该账号开启了MFA（多因素验证），常规登录密码无法用于SMTP认证，需要在账号安全设置中生成专属应用密码，替换配置文件中的原密码即可。
• 检查出口IP信誉：如果服务出口IP短时间发送大量邮件触发Office365反垃圾规则，会被临时拦截并返回认证类错误，可临时切换网络环境测试验证。

内容的提问来源于stack exchange，提问作者Sackling