Laravel Breeze集成Fortify后2FA验证界面不跳转问题

1. 确认Fortify已启用2FA功能 #

打开config/fortify.php，找到features数组，必须包含Features::twoFactorAuthentication()：

'features' => [
    Features::registration(),
    Features::resetPasswords(),
    Features::emailVerification(),
    Features::updateProfileInformation(),
    Features::updatePasswords(),
    Features::twoFactorAuthentication(), // 这一行必须存在
],

2. 确保登录路由指向自定义控制器 #

Breeze默认登录路由可能仍使用自身控制器，需要修改路由配置。打开routes/auth.php（或web.php），将登录POST路由指向你自定义的AuthenticatedSessionController：

use App\Http\Controllers\Auth\AuthenticatedSessionController;

Route::post('/login', [AuthenticatedSessionController::class, 'store'])
    ->middleware(['guest']);

3. 验证用户模型的2FA集成 #

确保App\Models\User模型引入TwoFactorAuthenticatable特质：

use Laravel\Fortify\TwoFactorAuthenticatable;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable, TwoFactorAuthenticatable; // 包含该特质
    // ...其他代码
}

4. 检查登录管道的动作执行逻辑 #

你的AuthenticatedSessionController中loginPipeline方法的动作顺序是正确的，但可以临时去掉条件判断，强制加载RedirectIfTwoFactorAuthenticatable测试：

return (new Pipeline(app()))->send($request)->through(array_filter([
    config('fortify.limiters.login') ? null : EnsureLoginIsNotThrottled::class,
    config('fortify.lowercase_usernames') ? CanonicalizeUsername::class : null,
    RedirectIfTwoFactorAuthenticatable::class, // 直接添加，去掉条件判断
    AttemptToAuthenticate::class,
    PrepareAuthenticatedSession::class,
]));

5. 清除缓存后重新测试 #

执行以下命令清除配置、路由和应用缓存：

php artisan config:clear
php artisan route:clear
php artisan cache:clear

额外排查点 #

• 再次确认数据库中用户的two_factor_secret字段不为空
• 检查会话存储是否正常，登录时用户ID是否被正确写入会话
• 可以在RedirectIfTwoFactorAuthenticatable类中添加日志输出，确认该动作是否被执行

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