SMTP服务器拒绝data消息时PHPMailer抛出混淆错误的排查

问题现象 #

Web服务器应用通过PHPMailer调用SMTP服务器发送邮件，初期运行正常，突然抛出以下类型错误：

Exception::__construct(): Argument #2 ($code) must be of type int, array given

排查过程 #

1. 尝试常规调试，但PHPMailer输出的调试信息无法定位真实问题
2. 升级PHPMailer至7.1.1版本，问题依旧存在
3. 直接查看PHPMailer源码中SMTP.php的sendMessage()方法，手动插入代码打印SMTP交互的错误详情，才定位到核心问题：
   • 这是PHPMailer的一处错误处理bug：当SMTP服务器接收DATA指令时返回错误，PHPMailer错误地将包含错误信息的数组传递给Exception构造函数的第二个参数（该参数要求传入整数类型的错误码）
4. 追踪SMTP原始错误响应后确认，实际根因是邮件服务账号被封禁，SMTP服务器返回的错误被PHPMailer的错误处理逻辑掩盖，转而抛出了类型不匹配的异常

修复方案 #

• 临时修复：在sendMessage()方法处理SMTP错误的位置，提取错误数组中的整数错误码，再传入Exception构造函数，避免类型错误
• 根本解决：联系邮件服务商解封账号，同时留意PHPMailer官方后续版本是否修复该错误处理逻辑

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