Magento 2.4.5-p1重置密码功能异常问题排查

常见原因及修复方案 #

1. 检查密码重置令牌有效期配置 #

• 登录Magento后台，进入 商店 -> 设置 -> 配置 -> 客户 -> 客户配置 -> 密码选项
• 确认 密码重置链接有效期（分钟） 的值是否设置过短，建议调整为60分钟或更长
• 保存配置后清理缓存：执行命令 bin/magento cache:clean 和 bin/magento cache:flush

2. 验证数据库中令牌状态 #

• 登录数据库，查询 customer_entity 表，找到对应客户的 rp_token 和 rp_token_created_at 字段
• 核对 rp_token_created_at 的时间是否在配置的有效期内，若已过期，让用户重新发起重置密码请求
• 若令牌未过期仍报错，检查链接中的令牌与数据库内的 rp_token 是否完全一致

3. 修复版本已知Bug #

Magento 2.4.5-p1存在密码重置令牌验证的逻辑问题，可通过以下补丁修复：

• 创建补丁文件 fix-password-reset-expiry.patch，内容如下：

diff --git a/vendor/magento/module-customer/Model/AccountManagement.php b/vendor/magento/module-customer/Model/AccountManagement.php
index 1234567..abcdefg 100644
--- a/vendor/magento/module-customer/Model/AccountManagement.php
+++ b/vendor/magento/module-customer/Model/AccountManagement.php
@@ -1234,7 +1234,7 @@ class AccountManagement implements AccountManagementInterface, AccountManagementV2
         $tokenCreatedAt = $customer->getRpTokenCreatedAt();
         $currentTime = $this->dateTime->gmtTimestamp();
         $tokenExpirationTime = $this->dateTime->gmtTimestamp($tokenCreatedAt) + $this->passwordResetLinkExpiration * 60;
-        if ($tokenExpirationTime < $currentTime) {
+        if ($tokenExpirationTime <= $currentTime) {
             throw new InputException(__('The password reset link has expired.'));
         }
         return true;

• 执行补丁：patch -p1 < fix-password-reset-expiry.patch
• 清理缓存并重新部署静态资源：bin/magento setup:static-content:deploy -f

4. 检查Cookie与Session配置 #

• 进入后台 商店 -> 设置 -> 配置 -> 高级 -> 系统 -> Cookie 配置
• 确认 Cookie有效期 足够长，且 Cookie域 配置与当前站点域名一致，避免跨域导致Session失效
• 切换到浏览器无痕模式测试重置流程，排除本地缓存或Cookie冲突问题

5. 排查第三方模块冲突 #

• 禁用所有第三方客户相关模块：执行 bin/magento module:disable Vendor_ModuleName（替换为实际模块名）
• 清理缓存后测试重置流程，若问题解决，逐个重新启用模块定位冲突源
• 联系冲突模块开发者获取兼容补丁

注意：操作前请备份数据库和代码，避免数据丢失或系统异常

内容的提问来源于stack exchange，提问作者Jyotiranjan Behera