You need to enable JavaScript to run this app. Laravel 8 Jetstream 如何实现强制首次登录修改密码
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 8 Jetstream 如何实现强制首次登录修改密码

可行实现方案

核心思路

完全不需要在每个控制器重复写校验逻辑,直接通过路由中间件实现全局拦截,在用户登录后的路由链路里自动完成状态校验,强制引导未修改初始密码的用户跳转改密页。
比起监听登录事件做跳转的方案,中间件实现的可靠性更高:不管用户是登录后停留很久再访问其他页面,还是通过书签直接打开某内页,只要满足未改密的条件就会被拦截,不会出现漏判。

分步实现

1. 基础配置补全

你提到要给users表加password_changed_at字段,这里补全容易遗漏的配置,避免后续功能失效:

  • 迁移文件定义字段时指定为可空时间类型:
    Schema::table('users', function (Blueprint $table) {
        $table->timestamp('password_changed_at')->nullable()->after('password');
    });
    
  • 在User模型中把该字段加入可批量赋值的$fillable数组,否则后续自动赋值会被拦截:
    protected $fillable = [
        'name',
        'email',
        'password',
        'password_changed_at',
    ];
    
  • 新建用户生成系统随机初始密码时,不要给password_changed_at赋值(保持默认null即可),刚好匹配首次强制改密的触发条件。

2. 创建全局拦截中间件

执行命令生成中间件:
php artisan make:middleware ForcePasswordChange
在生成的中间件app/Http/Middleware/ForcePasswordChange.php的handle方法中写入核心逻辑:

  • 跳过未登录用户的校验
  • 已登录用户如果password_changed_at已经有值,直接放行
  • 排除改密页面、改密提交接口、登出接口这些白名单路由,避免出现“重定向次数过多”的死循环
  • 所有不满足放行条件的请求,直接重定向到自定义改密页
    代码参考:
public function handle(Request $request, Closure $next)
{
    // 未登录用户直接放行,不做校验
    if (!Auth::check()) {
        return $next($request);
    }

    $currentUser = Auth::user();
    // 已经完成过密码修改的用户直接放行
    if (!is_null($currentUser->password_changed_at)) {
        return $next($request);
    }

    // 配置白名单路由,避免无限重定向
    $allowRoutes = [
        'password.change.show',
        'password.change.update',
        'logout',
    ];
    // 当前访问的是白名单路由的话直接放行
    if (in_array($request->route()->getName(), $allowRoutes)) {
        return $next($request);
    }

    // 强制跳转改密页
    return redirect()->route('password.change.show');
}

3. 注册并挂载中间件

  • 先在app/Http/Kernel.php的路由中间件数组里给这个中间件起个别名,方便调用:
    protected $routeMiddleware = [
        // ... 框架自带的原有配置
        'force.password.change' => \App\Http\Middleware\ForcePasswordChange::class,
    ];
    
  • 把这个中间件挂载到所有需要登录访问的路由组上,和auth认证中间件搭配使用,比如在routes/web.php里:
    // 所有需要登录才能访问的业务路由,统一加两个中间件:先校验是否登录,再校验是否需要强制改密
    Route::middleware(['auth', 'force.password.change'])->group(function () {
        // 这里放原有所有的业务路由,Jetstream自带的控制台、个人资料等路由也统一归到这个组里
    });
    
    // 改密相关的两个路由不需要被强制拦截,单独写在组外面
    Route::get('/initial-password-set', [ChangePasswordController::class, 'show'])->name('password.change.show')->middleware('auth');
    Route::post('/initial-password-set', [ChangePasswordController::class, 'update'])->name('password.change.update')->middleware('auth');
    

4. 改密逻辑落地

新建对应的ChangePasswordController,在提交改密的方法里完成两个核心动作:

  • 校验用户输入的原密码是否正确、新密码是否符合强度规则
  • 更新用户密码的同时,把password_changed_at赋值为当前时间
    核心代码参考:
public function update(Request $request)
{
    // 用框架自带的校验规则,不需要自己重复写
    $request->validate([
        'current_password' => ['required', 'current_password'],
        'password' => ['required', Password::defaults(), 'confirmed'],
    ]);

    $request->user()->update([
        'password' => Hash::make($request->password),
        'password_changed_at' => now(),
    ]);

    return redirect()->route('dashboard')->with('status', '初始密码修改完成');
}

常见踩坑提醒

  • 一定要把改密路由、登出路由加入中间件的白名单,否则会触发浏览器的重定向次数超限报错
  • 如果有管理员后台重置用户密码的功能,重置时要把对应用户的password_changed_at重置为null,否则用户下次登录不会触发强制改密逻辑
  • 你之前在JetstreamServiceProvider里写的自定义authenticateUsing逻辑不需要改动,和中间件逻辑完全兼容,不会有冲突

内容的提问来源于stack exchange,提问作者PendejoTrax

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 02:06:04