Laravel Password重置_忘记密码重置流程【介绍】-php教程-PHP中文网

Laravel密码重置依赖CanResetPassword接口、password_reset_tokens表、预置控制器和邮件链路；常见问题源于邮件配置错误、令牌未哈希存储、时间戳不准或HTTPS强制导致链接失效。

laravel password重置_忘记密码重置流程【介绍】

直接上结论：Laravel 的密码重置不是“手写逻辑”，而是依赖 CanResetPassword 接口、password_reset_tokens 表、预置控制器和邮件通知链路的一套闭环机制；只要表存在、邮件通、路由注册正确，90% 的问题出在配置或令牌验证环节。

为什么 /password/email 提交后没发邮件，也没报错？

这是最常卡住的点——表面静默，实际失败。根本原因通常是邮件驱动未生效或配置被覆盖。

MAIL_MAILER 必须在 .env 中显式设置（如 smtp 或 log），不能只配 MAIL_DRIVER（旧键名，Laravel 8+ 已弃用）
若用 log 驱动测试，确保 storage/logs/laravel.log 有写入权限，且日志里能看到类似 Sent [Illuminate\Notifications\Messages\MailMessage] to user@example.com 的记录
config/mail.php 中的 'from' 配置必须与 .env 的 MAIL_FROM_ADDRESS 一致，否则部分 SMTP 服务会拒信
如果用了 Nginx/Apache 反向代理，但没启用 TrustHosts 中间件，url() 生成的重置链接可能带错 host，导致点击后 404 或跳转失败

用户点击邮件链接提示 “Invalid password reset token”

这个错误不等于“令牌不存在”，而更可能是校验逻辑提前中断了。重点查三处：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

数据库中 password_reset_tokens 表的 token 字段是 varchar(128)，但你存进去的是未哈希的原始字符串（Laravel 默认用 hash_hmac('sha256', $token, $secret) 存储）。手动插入测试数据时千万别直接写明文
检查 ResetPasswordController@reset() 方法里是否调用了 $request->validate()，且 rules() 中对 token 的验证规则是否误加了 'exists'（框架底层已做存在性+时效性校验，重复验证会导致 404）
时间戳字段 created_at 必须是当前时区的准确值；如果服务器时间比数据库慢几分钟，刚生成的令牌可能被判定为“已过期”（默认有效期 60 分钟）

如何安全地自定义重置邮件内容？

不要改 vendor/ 下的类，也不要用全局替换视图。标准做法是发布并覆盖 Mailable 类：

运行 php artisan vendor:publish --tag=laravel-notifications，生成 resources/views/vendor/notifications/email.blade.php
在 User 模型中重写 sendPasswordResetNotification() 方法，显式指定自定义 Mailable：

use App\Mail\CustomPasswordReset;

public function sendPasswordResetNotification($token)
{
    $this->notify(new CustomPasswordReset($token));
}

自定义 CustomPasswordReset 类中，务必保留 $this->token = $token 并在 build() 里调用 $this->subject(...)，否则重置链接里的 {token} 不会被注入

真正容易被忽略的是：所有重置流程都依赖 HTTPS。开发环境用 http:// 时，浏览器可能拦截重置链接中的 rel="noopener" 属性，或 Laravel 自动将 url() 生成为 https:// 导致跳转失败。临时解决可加 URL::forceScheme('http') 到 AppServiceProvider@boot()，但上线前必须切回 HTTPS。