Laravel密码重置是依赖CanResetPassword接口、password_reset_tokens表、预置控制器和邮件通知链路的闭环机制；90%问题源于配置错误或令牌验证异常，如MAIL_MAILER未正确设置、token未哈希存储、时间戳不准或HTTPS/TrustHosts配置不当。
直接上结论：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”
这个错误不等于“令牌不存在”，而更可能是校验逻辑提前中断了。重点查三处：
- 数据库中
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)); }
忘记管理员密码时怎么快速恢复？
开发或紧急场景下，tinker 是最快路径，但要注意模型命名和字段名是否匹配当前项目：
- 运行
php artisan tinker - 查找用户：
$user = App\Models\User::where('email', 'admin@example.com')->first();（注意 Laravel 8+ 默认模型路径是App\Models\User） - 重置密码：
$user->password = \Illuminate\Support\Facades\Hash::make('newpass123'); $user->save(); - 如果模型用的是
username而非email字段登录，记得改查询条件，比如where('username', 'admin')
真正容易被忽略的是：Hash::make() 必须用全限定名或先 use，否则在 tinker 里会报 Class 'Hash' not found；另外，重置后别忘了清空该用户所有已存在的 session（可删 storage/framework/sessions 下对应文件，或调用 Auth::logoutOtherDevices()）。
