PHPMailer 6.6.0中西语特殊字符显示异常求助

核心问题定位 #

你遇到的变量名不匹配报错是直接诱因——初始化用的是$mail，但设置属性时误用了$mailer，导致操作null对象报错，这也是字符集设置失效的根本原因之一。

具体解决步骤 #

1. 修正变量名一致性 #

确保初始化和后续配置使用同一个变量：

// 正确初始化
$mail = new PHPMailer();

// 用同一个变量设置字符集和编码
$mail->CharSet = 'UTF-8';
$mail->Encoding = 'quoted-printable';

注：quoted-printable编码对Outlook兼容性更好，这也是Thunderbird默认使用的编码方式，能有效避免特殊字符乱码。

2. 确保邮件内容本身为UTF-8编码 #

• 若内容来自数据库：确保数据库连接字符集为UTF-8（比如MySQL执行SET NAMES utf8mb4）
• 若为硬编码字符串：将PHP文件保存为UTF-8无BOM格式（大多数IDE可在保存选项中设置）
• 若读取外部文件：用file_get_contents时指定编码，或转换内容为UTF-8

3. 移除手动添加的MIME头 #

PHPMailer会根据你设置的CharSet和Encoding自动生成正确的MIME头，手动添加的Content-type头会和PHPMailer生成的头冲突，导致字符集设置失效，直接删除手动添加的$headers代码即可。

完整示例代码 #

require 'PHPMailer/src/PHPMailer.php';
require 'PHPMailer/src/SMTP.php';
require 'PHPMailer/src/Exception.php';

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

// 初始化
$mail = new PHPMailer(true);

try {
    // 服务器配置
    $mail->SMTPDebug = SMTP::DEBUG_OFF;
    $mail->isSMTP();
    $mail->Host = 'your-smtp-host';
    $mail->SMTPAuth = true;
    $mail->Username = 'your-email';
    $mail->Password = 'your-password';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    // 关键字符集和编码设置
    $mail->CharSet = 'UTF-8';
    $mail->Encoding = 'quoted-printable';

    // 收件人配置
    $mail->setFrom('from@example.com', 'Sender Name');
    $mail->addAddress('recipient@example.com', 'Recipient Name');

    // 邮件内容（含西班牙语特殊字符）
    $mail->isHTML(true);
    $mail->Subject = 'Comentario: Sábado Mañana';
    $mail->Body    = '<p>Comentario: Sábado Mañana</p>';
    $mail->AltBody = 'Comentario: Sábado Mañana';

    $mail->send();
    echo '邮件发送成功';
} catch (Exception $e) {
    echo "邮件发送失败: {$mail->ErrorInfo}";
}

逻辑验证 #

Thunderbird能正常显示的原因是它默认采用UTF-8字符集+quoted-printable编码，上述配置完全对齐这个逻辑，因此能解决Outlook中的乱码问题。

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