1. 为什么你的项目需要两套独立的登录体系?
最近在帮一个朋友的公司做技术重构,他们遇到了一个非常典型的问题。他们用若依框架快速搭建了一个后台管理系统,用来管理商品、订单和用户数据,运营得挺好。后来业务发展,需要做一个面向普通用户的手机App和小程序,也就是会员系统。最初的设想很简单:后台管理员用若依自带的系统用户表登录,前台会员用另一张会员表登录,共用一套后端服务,省时省力。
但问题很快就来了。他们发现,会员登录后,竟然能通过接口看到一些后台管理的数据;更离谱的是,在某些情况下,一个测试用的会员账号ID如果和某个管理员ID巧合地相同,权限似乎出现了混乱。这可不是小事,数据安全和权限隔离是底线。他们最初的尝试就是在若依的登录接口上“打补丁”,根据一个type参数来判断是会员登录还是管理员登录,然后在同一个UserDetailsService里写一堆if-else。结果代码越改越乱,维护起来像在走钢丝,生怕动了一个地方,另一边就崩了。
这其实就是典型的 “多用户体系” 认证隔离问题。在一个现代的前后端分离应用中,特别是中小型项目为了快速迭代,常常会让会员端(C端)和管理端(B端)共享同一个后端服务。若依(RuoYi)框架基于Spring Security,本身提供了强大且完善的后台管理认证授权方案。但当我们想把另一套完全不同的用户体系(比如会员、商户、合作伙伴)也集成进来时,如果处理不当,就会像上面那样,出现用户信息串台、权限边界模糊的安全隐患。
所以,今天我们就来彻底解决这个问题。目标很明确:在若依框架的基础上,利用Spring Security的灵活性,构建两套物理隔离的登录认证流程。让会员登录和管理员登录,从数据查询、密码校验、Token生成到权限验证,全程走两条独立的通道,互不干扰,清晰安全。我会分享两种实战方案,一种“正统”但稍复杂,一种“取巧”但简单直接,你可以根据项目实际情况选择。
2. 理解核心:Spring Security的认证流程与关键角色
在动手之前,我们得先摸清Spring Security在若依框架里是怎么工作的。你不用怕,我们不用深究那些晦涩的理论,就把它想象成一个严格的“小区门禁系统”。
- 用户来访(登录请求):你(用户)走到大门口(登录接口
/login),出示用户名和密码。 - 保安亭查询(UserDetailsService):保安(
AuthenticationManager)拿到你的信息后,不会自己查档案。他会去固定的保安亭(UserDetailsService)调取住户档案。在若依里,这个“保安亭”默认叫UserDetailsServiceImpl,它只认sys_user系统用户表。 - 档案核对(UserDetails):保安亭根据用户名,从数据库里找到对应的住户档案,并封装成一个标准格式的档案袋(
UserDetails接口的实现类)。在若依里,这个档案袋就是LoginUser对象,里面装着用户ID、密码、权限列表等信息。 - 身份核验(AuthenticationProvider):保安比对你输入的密码和档案袋里记录的密码是否一致。这一步通常由
DaoAuthenticationProvider完成。 - 发放门禁卡(Token生成与存储):核验通过后,保安系统会生成一张唯一的“门禁卡”(JWT Token或类似令牌),并把这卡和你的档案袋复印件一起存到小区的中央储物柜(Redis)里。然后把这张卡交给你。
- 持卡进入(访问接口):之后你每次想进入小区内的各个楼栋(访问API),只需要在门口刷一下这张卡(在请求头中携带Token)。门口的读卡器(
JwtAuthenticationTokenFilter)会验证卡的有效性,并从中央储物柜里取出你的档案袋复印件,告诉楼栋管理员:“这是XX业主,他有这些权限”。 - 权限检查(SecurityConfig):楼栋管理员根据你的权限,决定是否放行你去特定的房间(接口)。
那么,问题出在哪? 默认情况下,整个小区只有一个保安亭(UserDetailsServiceImpl),它只存放sys_user表的档案。现在,小区里新开了一片“会员公寓”,住户信息在另一本member花名册里。如果我们强行让原来的保安亭也去管会员档案,就会导致档案管理混乱,甚至可能发错门禁卡。
我们的改造核心,其实就是为“会员公寓”设立一个独立的、全新的保安亭和工作流程。 让会员走会员的通道,管理员走管理员的通道,两套档案系统完全分开。下面,我们就开始搭建这个“双通道”门禁系统。
3. 方案一:深度整合,构建独立的Spring Security认证链
这个方案思路最清晰,也最符合Spring Security的设计哲学。我们为会员体系从头到尾打造一条独立的认证流水线。虽然步骤稍多,但结构优雅,扩展性好。我建议在业务逻辑复杂、会员体系未来可能多变的情况下使用。
3.1 第一步:建立独立的用户档案(实体与Mapper)
首先,会员得有独立的“户口本”。假设我们有一张会员表shop_member,对应的实体类ShopMember。我强烈建议你把这个实体类、以及操作它的ShopMemberMapper接口和XML文件,都放在项目的common模块或者一个独立的member模块里。这样,认证模块和服务模块都能方便地引用它,避免循环依赖。
// 示例:ShopMember 实体类 (位于 common 模块)
@Data
@TableName("shop_member")
public class ShopMember {
private Long id; // 会员ID
private String username; // 登录名,可能是手机号
private String password; // 加密后的密码
private String nickName; // 昵称
private String phone; // 手机号
private Integer status; // 状态 0正常 1停用
// ... 其他业务字段
}
你的ShopMemberMapper需要至少提供一个根据登录名(如手机号)查询会员的方法,这是后续认证的基石。
3.2 第二步:创建专属的保安亭(实现UserDetailsService)
接下来,为会员建立专属的“保安亭”。我们创建一个新的ShopMemberDetailsServiceImpl,实现Spring Security的UserDetailsService接口。它的唯一职责就是:根据用户名(这里是手机号)从shop_member表里加载会员信息。
这里有个关键细节:Spring容器里现在会有两个UserDetailsService,一个是若依默认的,一个是我们新建的。我们需要通过@Component注解给它们起不同的名字,以便后续区分。
@Component("shopMemberDetailsService") // 给它一个特定的Bean名称
public class ShopMemberDetailsServiceImpl implements User
310



被折叠的 条评论
为什么被折叠?



