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
相关产品推荐
相关产品推荐

