Wave V3 SaaS模板中实现邮箱验证的方法咨询

1. 补全注册时的验证字段初始化逻辑 #

找到Wave的注册控制器app/Http/Controllers/Auth/RegisterController.php，在用户创建的create方法里，强制添加验证字段的赋值逻辑：

use Illuminate\Support\Str;

// ...

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

    // 新增以下代码，初始化验证状态
    $user->verification_code = Str::random(40);
    $user->verified = false;
    $user->save();

    // 调用发送验证邮件的逻辑（如果Wave已有封装方法直接用，没有就自己写）
    $user->sendEmailVerificationNotification();

    return $user;
}

如果注册逻辑是基于DevDojo Auth的Trait实现的，就去扩展对应的Trait，确保用户创建时执行上述字段赋值。

2. 修复验证路由与处理逻辑 #

取消routes/web.php中的验证路由注释后，确保路由指向正确的控制器方法，示例：

use App\Http\Controllers\Auth\VerificationController;

Route::get('/email/verify/{id}/{verification_code}', [VerificationController::class, 'verify'])->name('verification.verify');

然后创建VerificationController并实现验证逻辑：

namespace App\Http\Controllers\Auth;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use App\Http\Controllers\Controller;

class VerificationController extends Controller
{
    public function verify(Request $request)
    {
        $user = User::where('id', $request->id)
                    ->where('verification_code', $request->verification_code)
                    ->first();

        if (!$user) {
            return redirect('/login')->with('error', '验证链接无效或已过期');
        }

        // 更新验证状态
        $user->verified = true;
        $user->email_verified_at = now();
        $user->verification_code = null; // 清空验证码避免重复使用
        $user->save();

        Auth::login($user);
        return redirect('/dashboard')->with('success', '邮箱验证成功');
    }
}

3. 确保验证邮件携带正确参数 #

检查发送验证邮件的视图文件（一般在resources/views/auth/verify-email.blade.php），确保链接正确传递用户ID和验证码：

<a href="{{ route('verification.verify', ['id' => $user->id, 'verification_code' => $user->verification_code]) }}">
    点击验证你的邮箱
</a>

4. 添加邮箱验证强制拦截（可选） #

如果需要限制未验证用户访问后台，自定义一个verified中间件：

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class EnsureEmailIsVerified
{
    public function handle(Request $request, Closure $next)
    {
        if (!Auth::check() || !Auth::user()->verified) {
            return redirect('/verify-email')->with('warning', '请先验证你的邮箱才能访问此页面');
        }

        return $next($request);
    }
}

在app/Http/Kernel.php中注册中间件，然后给后台路由组添加该中间件：

Route::middleware(['auth', 'verified'])->group(function () {
    // 后台仪表盘、设置等路由
});

5. 确认数据库字段正确性 #

检查users表的字段是否符合要求：

• verification_code：字符串类型，允许为空
• verified：布尔类型，默认值false
• email_verified_at：时间戳类型，允许为空
  如果字段缺失，创建迁移文件补充：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('verification_code')->nullable();
            $table->boolean('verified')->default(false);
            $table->timestamp('email_verified_at')->nullable();
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn(['verification_code', 'verified', 'email_verified_at']);
        });
    }
};

执行迁移：php artisan migrate

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