使用SendGrid发送验证邮件失败问题求助

我正在为学校开发一个PromptBase平台，搭建了注册系统——用户输入邮箱和密码即可创建账号，之后需通过SendGrid发送验证邮件。我已注册SendGrid账号并获取API Key，但代码始终无法正常运行。

报错信息显示new SendGrid\Email等对象未被识别，具体提示：Undefined type 'SendGrid\Mail\HtmlContent'.intelephense(1009)

已做的尝试：

• 通过composer require sendgrid/sendgrid安装了^8.0版本的依赖，终端显示安装过程无异常
• 尝试添加require 'vendor/autoload.php'和require_once __DIR__ . '/vendor/autoload.php'引入自动加载文件
• 引入了对应命名空间：

use SendGrid\Mail\From;
use SendGrid\Mail\HtmlContent;
use SendGrid\Mail\Mail;
use SendGrid\Mail\PlainTextContent;
use SendGrid\Mail\Subject;
use SendGrid\Mail\To;

• 修改邮件构建代码，但问题依旧

请问该如何解决？或者有没有其他邮件验证的实现方案？

1. 确认自动加载路径正确性 #

确保require_once的路径能正确指向项目根目录下的vendor/autoload.php。如果代码文件不在项目根目录，需要调整路径层级，示例：

// 假设当前文件在项目根目录的src/子文件夹中
require_once __DIR__ . '/../vendor/autoload.php';

可通过打印当前目录路径验证：

echo __DIR__; // 输出当前文件所在目录，确认是否能定位到vendor文件夹

2. 清理Composer缓存并重装依赖 #

缓存异常可能导致依赖加载失败，执行以下命令：

composer clear-cache
composer install

安装完成后检查vendor/sendgrid/sendgrid/src/Mail目录下，是否存在HtmlContent.php等对应类文件。

3. 修复编辑器Intelephense报错（仅编辑器提示，代码实际可运行的情况） #

如果只是VS Code等编辑器的Intelephense提示错误，可尝试：

• 重启编辑器，让其重新扫描项目文件
• 在VS Code设置中，确保intelephense.environment.includePaths包含vendor目录
• 执行composer dump-autoload重新生成自动加载映射文件

4. 遵循SendGrid v8.x的正确使用规范 #

SendGrid v8.x的API与旧版本有差异，无需单独实例化HtmlContent、PlainTextContent等类，正确示例代码如下：

require_once __DIR__ . '/vendor/autoload.php';

use SendGrid\Mail\Mail;

$email = new Mail();
$email->setFrom('your-verification@example.com', 'PromptBase 验证');
$email->setSubject('请验证你的邮箱');
$email->addTo('user-target@example.com', '用户名');
$email->addContent('text/plain', '点击链接验证邮箱：https://your-domain.com/verify?token=xxx');
$email->addContent(
    'text/html',
    '<strong>点击链接验证邮箱：</strong><a href="https://your-domain.com/verify?token=xxx">验证链接</a>'
);

$sendgrid = new \SendGrid('YOUR_SENDGRID_API_KEY');
try {
    $response = $sendgrid->send($email);
    echo $response->statusCode();
} catch (Exception $e) {
    echo 'Caught exception: '. $e->getMessage() ."\n";
}

如果SendGrid的问题始终无法解决，可考虑以下方案：

• PHPMailer：轻量流行的PHP邮件库，支持SMTP发送，配置简单兼容性强
• SwiftMailer：成熟的PHP邮件处理库，支持多种发送方式
• 学校内部SMTP服务器：若学校提供自有邮件服务器，可直接通过SMTP发送验证邮件，无需依赖第三方服务

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