PHPMailer配置Gmail OAuth2发信报SMTP类未找到错误排查

报错Fatal error: Uncaught Error: Class 'Phppot\SMTP' not found和Gmail OAuth2认证逻辑无关，是代码层面的类加载错误，核心问题是错误引用了不存在的命名空间下的SMTP类，具体问题点和修复方案如下：

具体问题点 #

• 命名空间引用错误：你参考的教程中Phppot是教程作者自定义的业务代码命名空间，PHPMailer自带的SMTP类原生命名空间为PHPMailer\PHPMailer\SMTP，直接照搬教程里的Phppot\SMTP调用，PHP无法定位到对应类文件，直接抛出致命错误。
• 自动加载配置缺失：如果没有引入Composer生成的自动加载文件，或者手动部署PHPMailer及OAuth依赖时漏引入SMTP类文件，即使命名空间写对也会出现类找不到的问题。
• 类文件路径不匹配：手动下载源码部署时，PHPMailer源码存放路径和代码里的require路径不一致，也会导致类加载失败。

修复步骤 #

1. 修正类引用声明
   在MailService.php文件头部添加正确的依赖引入和类声明，如果你是用Composer管理依赖，先引入自动加载文件：

   // 按项目实际目录调整autoload.php的路径
   require_once __DIR__ . '/../vendor/autoload.php';
   
   use PHPMailer\PHPMailer\PHPMailer;
   use PHPMailer\PHPMailer\SMTP;
   use PHPMailer\PHPMailer\OAuth;
   use League\OAuth2\Client\Provider\Google;
   

   找到文件第31行的SMTP实例化代码，把原来的new Phppot\SMTP()替换为new SMTP()即可。

2. 补全/校验依赖
   如果是Composer部署，在项目根目录执行命令安装完整依赖，避免缺文件：

   composer require phpmailer/phpmailer league/oauth2-google
   

   如果是手动下载源码部署，要确认PHPMailer源码包内的src/SMTP.php文件存在，并且在代码中手动引入所有需要的类文件，路径按实际存放位置调整：

   require_once __DIR__ . '/third_party/phpmailer/src/PHPMailer.php';
   require_once __DIR__ . '/third_party/phpmailer/src/SMTP.php';
   require_once __DIR__ . '/third_party/phpmailer/src/OAuth.php';
   require_once __DIR__ . '/third_party/oauth2-google/src/Provider/Google.php';
   

3. 加载有效性校验
   可以在实例化SMTP的代码前加一行调试代码，确认类能被正常识别：

   var_dump(class_exists(SMTP::class)); // 输出bool(true)代表加载正常
   

类加载问题修复后，再核对Google Cloud控制台创建的OAuth客户端ID、客户端密钥、已获取的刷新令牌、发信人邮箱配置是否匹配，避免后续出现OAuth认证失败的问题。

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