Laravel 11自定义验证邮件URL点击后出现404错误求助

你的404错误主要来自两个核心问题：

1. Hash生成逻辑错误：你使用Hash::make()（bcrypt加密）生成邮箱哈希，但Laravel官方邮箱验证要求用SHA-256哈希处理邮箱；同时手动urlencode会导致路由参数解析异常。
2. 路由参数匹配限制：Hash::make()生成的字符串包含斜杠（示例中的%2F是斜杠的URL编码），默认的路由参数{hash}不会匹配斜杠，导致路由无法匹配。

1. 修正User模型的verificationUrl方法 #

替换错误的Hash生成逻辑，采用Laravel官方规范的SHA-256哈希，同时去掉手动urlencode（URL::temporarySignedRoute会自动处理参数编码）：

public function verificationUrl()
{
    return URL::temporarySignedRoute(
        'verification.verify',
        now()->addMinutes(config('auth.verification.expire', 60)),
        [
            'id' => $this->getKey(),
            'hash' => hash('sha256', $this->email) // 使用SHA-256哈希邮箱
        ]
    );
}

2. 调整路由参数匹配规则 #

修改web.php中的路由，让{hash}参数支持匹配包含斜杠的字符：

Route::get('/email/verify/{id}/{hash:.+}', [EmailVerificationController::class, 'verify'])
    ->middleware(['auth', 'signed'])
    ->name('verification.verify');

这里的{hash:.+}表示匹配任意长度的任意字符（包括斜杠），确保路由能正确解析参数。

3. 完善控制器验证逻辑（可选但推荐） #

在控制器的verify方法中，先验证id和hash是否对应用户，避免直接依赖$request->user()可能带来的异常：

use Illuminate\Auth\Events\Verified;

public function verify(Request $request)
{
    $user = \App\Models\User::findOrFail($request->route('id'));

    // 验证hash是否与用户邮箱匹配
    if (!hash_equals(hash('sha256', $user->email), $request->route('hash'))) {
        abort(403, '无效的验证哈希');
    }

    if ($user->hasVerifiedEmail()) {
        return redirect()->route('dashboard');
    }

    if ($user->markEmailAsVerified()) {
        event(new Verified($user));
    }

    return redirect()->route('dashboard')->with('verified', true);
}

Laravel默认的邮件验证逻辑中，fulfill()方法会自动用SHA-256哈希邮箱生成符合规范的hash参数，同时路由参数处理也完全遵循官方规则，因此不会出现404问题。

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