Magento 2密码重置异常求助：链接过期且请求参数为空

我之前也碰到过这个一模一样的糟心问题！明明邮件里的重置链接带着正确的id和token，但点进去就提示过期，追踪AccountManagement.php里的validateResetPasswordLinkToken方法时，print_r($_REQUEST)还一直返回null，折腾了好久才找到几个关键排查点：

1. 别用$_REQUEST调试！改用Magento的请求对象 #

Magento的请求处理是封装过的，直接在模型层用超全局变量$_REQUEST根本拿不到正确的参数——因为请求参数是通过RequestInterface对象来传递的，不是直接暴露给超全局变量。

你可以通过依赖注入的方式获取请求对象来调试：

• 先在AccountManagement.php的构造函数里注入\Magento\Framework\App\RequestInterface：

public function __construct(
    // 保留原有的所有依赖项...
    \Magento\Framework\App\RequestInterface $request
) {
    // 原有的赋值代码...
    $this->request = $request;
}

• 然后在validateResetPasswordLinkToken方法里替换print_r($_REQUEST)为：

error_log("请求中的Customer ID: " . $this->request->getParam('id'));
error_log("请求中的Token: " . $this->request->getParam('token'));

之后查看var/log/system.log就能看到实际传递的参数了，这时候你会发现参数其实是存在的，只是之前的调试方式错了。

2. 检查URL重定向是否丢失了参数 #

如果你的网站有HTTPS强制重定向、或者自定义的URL重写规则，很可能在跳转过程中把id和token参数弄丢了：

• 检查Apache的.htaccess文件，确保重定向规则里包含[QSA]标记（Query String Append，保留查询参数），比如：

RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301,QSA]

• 如果是Nginx配置，确保重定向时传递$args参数，比如：

return 301 https://$host$request_uri$is_args$args;

3. 排查缓存与会话异常 #

有时候Magento的缓存或者会话存储出问题，也会导致密码重置逻辑异常：

• 执行命令清理所有缓存：

bin/magento cache:flush

• 检查会话存储目录权限（默认是var/session），确保Web服务器用户有读写权限；如果用Redis存储会话，检查Redis服务是否正常运行，配置是否正确。

4. 检查第三方模块干扰 #

不少第三方客户管理模块会重写AccountManagement类或者修改密码重置流程，导致参数处理异常：

• 先临时禁用所有第三方模块，只保留Magento核心模块：

bin/magento module:disable --all
bin/magento module:enable Magento_*
bin/magento setup:upgrade
bin/magento cache:flush

• 测试密码重置是否正常，如果恢复正常，再逐个启用第三方模块，找到干扰的那个模块。

最后补充：检查token过期时间 #

默认情况下Magento的密码重置token有效期是1小时，你可以在AccountManagement.php里查看getResetPasswordTokenExpirationPeriod()方法的返回值，确认过期时间是否设置合理。

内容的提问来源于stack exchange，提问作者P. Dev.