PHPMailer切换Gmail应用密码报错：Could not instantiate mail function

原本使用PHPMailer通过主机邮箱发送邮件的网站联系表单运行正常，切换为Gmail并使用应用密码后，表单无法发送邮件，返回错误：Mailer Error: Could not instantiate mail function。请问代码是否存在导致无法发送的问题？Gmail应用密码是否已失效？

相关代码 #

<?php

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

$myEmail = "********@gmail.com";
$myEmailPassword = "**** **** **** ****";
$myPersonalEmail = "**********";

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


$mail = new PHPMailer(true);

try {

    $mail->SMTPDebug = 0;

    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = $myEmail;
    $mail->Password = $myEmailPassword;
    $mail->SMTPSecure = 'tls';
    $mail->Port = 587;

    $mail->setFrom($myEmail, 'Mailer');
    $mail->addAddress($myPersonalEmail);
    $mail->addReplyTo($_POST['email'], $_POST['name']);

    $mail->isHTML(true);   
    $mail->Subject = $_POST['subject']; 
    $mail->Body = $_POST['message'];


$response = $_POST["g-recaptcha-response"];

    $url = 'https://www.google.com/recaptcha/api/siteverify';
    $data = array(
        'secret' => '********************',
        'response' => $_POST["g-recaptcha-response"]
    );
    $options = array(
        'http' => array (
            'method' => 'POST',
            'content' => http_build_query($data)
        )
    );
    $context  = stream_context_create($options);
    $verify = file_get_contents($url, false, $context);
    $captcha_success=json_decode($verify);

    if ($captcha_success->success==false) {
        echo "<p>Please try the captcha again.</p>";
        echo "<br><a href=\"javascript:history.go(-1)\">Go Back To Form</a>";        
    } else if ($captcha_success->success==true) {
        
        $mail->send();
    echo 'Your message was sent successfully!';
    }
} catch (Exception $e) { // handle error.
    echo 'Message could not be sent. Mailer Error: ', $mail->ErrorInfo;
}
?>

问题排查与解决 #

代码层面的核心问题 #

• 未启用SMTP模式：你已经配置了Gmail的SMTP参数，但缺少关键的$mail->isSMTP();调用。PHPMailer默认会使用服务器内置的mail()函数，这就是报错“无法实例化邮件函数”的根本原因。必须在配置SMTP参数前加上这行代码，强制使用SMTP协议发送邮件。
• 应用密码格式错误：Gmail应用密码是16位无空格的字符串，你代码里的密码带空格，要把空格全部去掉，比如把"**** **** **** ****"改成"****************"。
• 开启调试日志：暂时把$mail->SMTPDebug = 0;改成2，这样能输出详细的SMTP交互过程，方便排查连接、认证等具体问题，调试完成后再改回0。

Gmail应用密码有效性验证 #

• 确认你的Google账号已经开启两步验证，应用密码仅在开启两步验证后才生效，未开启的话应用密码无法使用。
• 检查应用密码是否是正确生成的：建议重新生成一个应用密码，选择“其他（自定义名称）”类型，复制时确保没有带多余空格或符号。
• 可以尝试用该应用密码登录Gmail客户端（比如Outlook），验证密码是否有效。

其他可能的问题 #

• 服务器是否放行587端口：部分主机商会限制出站SMTP连接，需要确认服务器防火墙或安全组允许访问smtp.gmail.com的587端口。
• 收件地址有效性：确认$myPersonalEmail是有效的邮箱地址，避免因收件地址错误导致的隐性问题。

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