Laravel注册后无法发送用户验证邮件问题排查求助

针对你遇到的注册后验证邮件未发送问题，结合你的Laravel 6.20.44版本和已排查的内容，补充以下针对性排查步骤：

1. 确认User模型实现MustVerifyEmail接口 #

Laravel的邮件验证功能依赖用户模型实现Illuminate\Contracts\Auth\MustVerifyEmail接口，否则sendEmailVerificationNotification()方法不会触发邮件发送。检查你的App\User模型：

<?php

namespace App;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable implements MustVerifyEmail
{
    use Notifiable;

    // ... 其他模型代码
}

确保类声明中包含implements MustVerifyEmail，这是触发验证邮件的核心前提。

2. 检查邮件队列配置与运行状态 #

如果你的.env中QUEUE_CONNECTION设置为database或redis（而非默认的sync），邮件会被推入队列异步发送，此时需要：

• 启动队列Worker：

php artisan queue:work

• 检查failed_jobs表，查看是否有失败的邮件任务，失败原因会记录在表中。

3. 手动测试基础邮件发送能力 #

直接在Artisan Tinker中测试邮件发送，排除SMTP配置问题：

php artisan tinker

执行测试代码：

Mail::raw('测试邮件内容', function($message) {
    $message->to('你的测试邮箱地址')->subject('Laravel邮件测试');
});

若测试邮件未收到：

• 确认.env中MAIL_FROM_ADDRESS与SMTP认证邮箱一致（多数服务商要求发件地址必须为已认证邮箱）；
• 检查邮箱服务商限制：比如Gmail需启用“低安全性应用访问”（或使用App密码），国内服务商需配置SPF/DKIM域名解析记录；
• 查看服务器PHP错误日志，SMTP连接失败的错误可能未被Laravel日志捕获，但会记录在PHP日志中。

4. 验证用户表email_verified_at字段配置 #

确保users表的email_verified_at字段满足：

• 字段类型为timestamp/datetime，且允许为NULL；
• 注册时该字段默认值为NULL（你的create方法未设置该字段，需确认数据库表定义中默认值为NULL）。

如果该字段被意外设置为非空值（比如默认当前时间），用户会被标记为已验证，邮件不会触发。

5. 调试邮件发送流程 #

在RegisterController的create方法中添加日志，确认sendEmailVerificationNotification()是否被执行：

use Illuminate\Support\Facades\Log;

protected function create(array $data)
{
    $user = User::create([
        'name' => $data['name'],
        'email' => $data['email'],
        'password' => Hash::make($data['password']),
    ]);

    Log::info('准备发送验证邮件至：' . $user->email);
    $user->sendEmailVerificationNotification();
    Log::info('验证邮件发送方法已执行');

    return $user;
}

查看storage/logs/laravel.log，若两条日志存在但邮件未收到，问题出在邮件发送环节；若日志不存在，需排查注册流程是否有未察觉的中断。

6. 检查Laravel与PHP版本兼容性 #

Laravel 6.x官方支持的PHP版本范围是7.2.5至7.4，你使用的PHP 8.0可能存在兼容性问题，部分邮件组件可能静默失败且不记录错误。建议暂时降级PHP到7.4测试，或确认Laravel 6是否有针对PHP 8.0的兼容补丁。

7. 确认验证邮件通知类配置 #

若你自定义了验证通知，需确保自定义类继承自Illuminate\Auth\Notifications\VerifyEmail，且逻辑正确：

// 自定义通知示例
namespace App\Notifications;

use Illuminate\Auth\Notifications\VerifyEmail as VerifyEmailNotification;

class CustomVerifyEmail extends VerifyEmailNotification
{
    // 自定义邮件内容或逻辑
}

同时在User模型中重写发送方法：

public function sendEmailVerificationNotification()
{
    $this->notify(new \App\Notifications\CustomVerifyEmail);
}

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