1. 为什么需要改造FastAdmin的单点登录机制
FastAdmin作为一款优秀的后台管理框架,默认提供了会员系统的单点登录功能。但在实际开发中,我们经常会遇到前后端分离的项目架构,比如前端使用Vue或React开发,后端仅提供API接口。这种情况下,官方手册提供的配置方式就显得力不从心了。
我最近就遇到了这样一个项目:前端是Vue3+TypeScript开发的管理系统,后端使用FastAdmin提供API接口。按照官方文档配置后,发现会员账号居然可以在多个设备同时登录,这显然不符合业务需求。经过排查发现,问题出在Token管理机制上。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 定位关键问题:Token管理机制
在前后端分离架构中,传统的session机制不再适用,取而代之的是基于Token的身份验证。FastAdmin默认的Token管理存在一个关键缺陷:当用户登录时,系统会生成新的Token,但不会清除旧的Token。这就导致同一个账号可以生成多个有效的Token,自然就能在多个客户端同时保持登录状态。
这个问题在纯后端渲染的项目中可能不明显,因为浏览器会自动管理cookie。但在API接口场景下,每个请求都需要显式携带Token,旧Token如果不及时清除就会一直有效。我在测试时就发现,用同一账号在手机和电脑上登录后,两个设备都能正常操作,这显然是个安全隐患。
3. 找到核心改造点:Auth.php文件
解决这个问题的关键就在app/common/library/Auth.php文件中。这个文件负责处理用户认证的核心逻辑,其中的login方法正是我们需要修改的地方。具体位置大概在234行左右,在用户密码验证通过后,直接登录会员之前。
原始代码是这样的:
php复制if ($user->password != $this->getEncryptPassword($password, $user->salt)) {
$user->save(['loginfailure' => $user->loginfailure + 1, 'loginfailuretime' => time()]);
$this->setError('Password is incorrect');
return false;
}
// 直接登录会员
ret
