Laravel如何处理含特殊字符的重置Token并正常返回视图？

我的Laravel路由代码：

Route::get('/password/reset/{token}', [PasswordResetController::class, 'showResetPasswordPage'])->name('password.reset.token');

控制器代码：

public function showResetPasswordPage(Request $request)
{
    $token = $request->route()->parameter('token');

    return view('resetpassword')->with(
        ['token' => $token]
    );
}

当传递普通Token（如1234）时，视图可正常返回并获取Token；但传递API返回的URL编码Token（如PKKGhoTq6Po3HzgpqThGyN1g8%2F%2BvPabz）时，会出现页面未找到（404）问题。

1. 修改路由参数约束，允许特殊字符 #

Laravel默认的路由参数匹配规则会排除/、.等特殊字符，而URL编码后的%2F解码后是/，会被当成路由分段，导致无法匹配到目标路由。给路由参数添加正则约束，允许匹配任意字符：

Route::get('/password/reset/{token}', [PasswordResetController::class, 'showResetPasswordPage'])
    ->where('token', '.*')
    ->name('password.reset.token');

.*正则表达式表示匹配任意长度的任意字符，这样就能完整捕获包含特殊编码的Token。

2. 直接使用自动解码后的Token #

Laravel会自动对路由参数进行URL解码，所以控制器中获取到的$token已经是解码后的原始值，无需额外处理。可以简化控制器代码：

public function showResetPasswordPage(Request $request)
{
    $token = $request->route('token');
    return view('resetpassword', compact('token'));
}

3. 确保生成重置链接时的编码正确性 #

如果是API生成密码重置链接，建议使用Laravel内置的route()函数生成，它会自动对参数进行URL编码，避免手动编码可能出现的错误：

// 生成正确的重置链接
$resetUrl = route('password.reset.token', ['token' => $rawToken]);

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