PHPMailer 群發 Gmail 完整指南：常見坑與解決方案

前言

使用 PHPMailer 透過 Gmail SMTP 群發郵件時，常遇到認證失敗、SSL 未啟用、連線中斷等問題。本文彙總實戰中遇到的核心問題及解決方案，助你快速建立穩定的郵件發送系統。

核心問題與解決方案

1. 「Could not authenticate」認證失敗

原因 A：帳號/密碼錯誤——確認使用「應用程式密碼」而非登入密碼（需開啟兩步驗證）。

原因 B：迴圈發送未關閉 SMTP 連線——每次 send() 後必須呼叫 SmtpClose()，否則第二封郵件會因連線殘留而失敗。

$mail = new PHPMailer(true);
foreach ($recipients as $to) {
    try {
        $mail->clearAddresses();
        $mail->addAddress($to);
        $mail->send();
    } catch (Exception $e) {
        // 記錄錯誤
    } finally {
        $mail->SmtpClose(); // 關鍵：每發一封關一次連線
    }
}

2. Gmail 要求 SSL/TLS 加密

PHP 必須啟用 OpenSSL 擴展，否則無法建立加密連線。

Windows 環境啟用 OpenSSL

1. 編輯 php.ini，取消註釋或添加：extension=php_openssl.dll
2. 將 PHP 目錄下的 php_openssl.dll、ssleay32.dll、libeay32.dll 複製到 C:\Windows\System32\（或 Apache/bin 目錄）
3. 重啟 Apache/IIS

Linux 環境動態編譯 OpenSSL 擴展（無需重編譯 PHP）

以 PHP 5.2.14 為例：

# 1. 下載對應版本原始碼
cd /var/www/php5
wget https://mirrors.sohu.com/php/php-5.2.14.tar.gz
tar zxvf php-5.2.14.tar.gz

# 2. 進入 openssl 擴展目錄
cd php-5.2.14/ext/openssl/

# 3. 執行 phpize（若報錯 config.m4 缺失，重命名 config0.m4）
mv config0.m4 config.m4
/var/www/php5/bin/phpize

# 4. 配置編譯
./configure --with-openssl --with-php-config=/var/www/php5/bin/php-config

# 5. 編譯安裝
make && make install

# 6. 修改 php.ini 添加 extension=openssl.so，重啟 PHP-FPM/Apache

3. PHPMailer Gmail 關鍵配置範本

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.gmail.com';
$mail->SMTPAuth   = true;
$mail->Username   = 'your@gmail.com';
$mail->Password   = 'your_app_password'; // 應用程式密碼
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // 或 SSL
$mail->Port       = 587; // SSL 用 465
$mail->CharSet    = 'UTF-8';
$mail->setFrom('your@gmail.com', '寄件者名稱');
$mail->isHTML(true);

進階建議

• 使用佇列：將郵件任務推入 Redis/RabbitMQ，由 Worker 異步發送，避免阻塞主程式並便於重試。
• 錯誤重試與日誌：記錄發送狀態、錯誤碼，對暫時性失敗（如網路抖動）實施指數退避重試。
• 發送頻率控制：Gmail 有每日發送上限（一般帳號 500 封/天），大量發送請使用 Google Workspace 或專業郵件服務（SendGrid、Mailgun、Amazon SES）。
• SPF/DKIM/DMARC：配置網域解析記錄，提升送達率，降低進垃圾箱風險。

總結

PHPMailer 群發 Gmail 核心在於：正確的認證方式（應用程式密碼）、啟用 OpenSSL、每封郵件獨立 SMTP 連線、頻率控制與佇列化。遵循最佳實踐，可構建高可用、高送達率的郵件系統。