1. Sa-Token框架的多账号认证需求背景在现代企业级应用开发中多账号类型并存是极为常见的场景。以典型的CMS系统为例通常需要同时支持Admin管理员账号和User普通用户账号的登录与权限控制。这两种账号类型在权限粒度、会话时长、安全等级等方面往往存在显著差异Admin账号需要更高的安全防护通常要求强制二次验证、频繁的会话过期检查、细粒度的操作日志记录User账号更注重用户体验会话保持时间较长权限控制相对简单传统做法是为每种账号类型单独实现一套认证逻辑但这会导致代码重复和维护成本增加。Sa-Token作为轻量级Java权限认证框架其多账号认证体系正是为解决这类问题而设计。2. 基础环境搭建与Sa-Token配置2.1 依赖引入与基础配置首先在Spring Boot项目中引入Sa-Token依赖以Maven为例dependency groupIdcn.dev33/groupId artifactIdsa-token-spring-boot-starter/artifactId version1.45.0/version /dependency然后在application.yml中进行基础配置sa-token: # 令牌名称 token-name: satoken # 令牌有效期单位秒 timeout: 86400 # 临时令牌有效期用于记住我功能 activity-timeout: 2592000 # 是否允许同一账号并发登录 is-concurrent: true # 在多人登录同一账号时是否共用一个token is-share: false2.2 多账号认证的核心配置在config包下创建SaTokenConfig.java配置多账号认证体系Configuration public class SaTokenConfig implements SaTokenConfigurator { Override public void configure(SaManagerConfig config) { // 配置多账号体系 config.setTokenStyle(uuid) .setTokenSessionCheckLogin(true) .setTokenActiveTimeout(3600); } }3. 实现Admin与User双账号认证体系3.1 账号类型枚举定义首先定义账号类型常量便于后续区分public class AccountType { public static final String ADMIN admin; public static final String USER user; }3.2 登录认证实现创建AuthService处理登录逻辑Service public class AuthService { Autowired private AdminMapper adminMapper; Autowired private UserMapper userMapper; public String login(String accountType, String username, String password) { switch (accountType) { case AccountType.ADMIN: Admin admin adminMapper.selectByUsername(username); if (admin null || !admin.getPassword().equals(password)) { throw new ApiException(管理员账号或密码错误); } // 管理员登录 StpUtil.login(admin.getId(), new SaLoginModel() .setDevice(PC) .setExtra(accountType, AccountType.ADMIN)); break; case AccountType.USER: User user userMapper.selectByUsername(username); if (user null || !user.getPassword().equals(password)) { throw new ApiException(用户账号或密码错误); } // 用户登录 StpUtil.login(user.getId(), new SaLoginModel() .setDevice(APP) .setExtra(accountType, AccountType.USER)); break; default: throw new ApiException(不支持的账号类型); } return StpUtil.getTokenValue(); } }3.3 权限校验实现创建自定义权限拦截器Component public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { // 获取当前登录账号类型 String accountType (String) StpUtil.getExtra(accountType); // 管理员专属接口校验 if (request.getRequestURI().startsWith(/admin/)) { if (!AccountType.ADMIN.equals(accountType)) { throw new NotPermissionException(无管理员权限); } } // 用户专属接口校验 if (request.getRequestURI().startsWith(/user/)) { if (!AccountType.USER.equals(accountType)) { throw new NotPermissionException(无用户权限); } } return true; } }4. 高级特性与安全增强4.1 差异化会话配置在SaTokenConfig中扩展配置// 管理员会话配置 StpUtil.StpLogic adminStpLogic new StpUtil.StpLogic(AccountType.ADMIN) .setTokenTimeout(7200) // 2小时过期 .setTokenActiveTimeout(1800); // 30分钟无操作过期 // 用户会话配置 StpUtil.StpLogic userStpLogic new StpUtil.StpLogic(AccountType.USER) .setTokenTimeout(259200) // 3天过期 .setTokenActiveTimeout(86400); // 1天无操作过期4.2 安全防护措施针对管理员账号增加安全防护public class AdminSecurityService { // 管理员登录需验证验证码 public void checkAdminLogin(String username, String code) { if (!CaptchaUtil.verify(code)) { throw new ApiException(验证码错误); } // 登录失败次数限制 String key admin:login:fail: username; Integer failCount RedisUtil.get(key); if (failCount ! null failCount 5) { throw new ApiException(账号已锁定请30分钟后重试); } } // 敏感操作需二次验证 public void checkAdminOperation(Long adminId) { if (!StpUtil.getExtra(secondAuth, false)) { throw new ApiException(请先完成二次验证); } } }5. 实战中的问题排查与优化5.1 常见问题排查问题1账号类型混淆导致权限错误现象用户账号可以访问管理员接口 排查步骤检查StpUtil.getExtra(accountType)返回值确认拦截器中的URI匹配规则验证登录时设置的extra参数问题2会话过期时间不生效解决方案确认是否为对应账号类型设置了正确的StpLogic实例检查是否有其他配置覆盖了超时设置通过StpUtil.getTokenInfo()查看实际生效的配置5.2 性能优化建议缓存优化为管理员和用户账号使用不同的缓存命名空间// 管理员缓存前缀 adminStpLogic.setTokenName(admin-token) .setJwtSecret(different-secret-for-admin); // 用户缓存前缀 userStpLogic.setTokenName(user-token) .setJwtSecret(different-secret-for-user);批量操作使用Sa-Token的批量API提升效率// 批量获取多个管理员登录状态 ListLong adminIds Arrays.asList(1L, 2L, 3L); MapLong, Boolean loginStatus StpUtil.checkLogin(adminIds);6. 扩展功能实现6.1 基于账号类型的权限注解创建自定义权限注解Retention(RetentionPolicy.RUNTIME) Target(ElementType.METHOD) public interface SaCheckAccountType { String value(); }实现注解处理器public class SaCheckAccountTypeInterceptor implements SaInterceptor { Override public boolean preHandle(Object handler) { Method method ((HandlerMethod) handler).getMethod(); SaCheckAccountType annotation method.getAnnotation(SaCheckAccountType.class); if (annotation ! null) { String requiredType annotation.value(); String actualType (String) StpUtil.getExtra(accountType); if (!requiredType.equals(actualType)) { throw new NotPermissionException(账号类型不符); } } return true; } }使用示例SaCheckAccountType(admin) PostMapping(/admin/resetPassword) public Result resetPassword() { // 管理员专属方法 }6.2 多设备登录管理实现不同账号类型的设备管理public class DeviceService { // 获取管理员所有登录设备 public ListSaSession getAdminDevices(Long adminId) { return StpUtil.searchSession( session - AccountType.ADMIN.equals(session.get(accountType)) adminId.equals(session.getLoginId()), 0, -1 ); } // 强制下线指定设备 public void kickoutDevice(String deviceId, String accountType) { StpUtil.kickoutByDevice(deviceId, accountType); } }在实际项目中我曾遇到一个典型场景某电商系统需要支持商家管理员Admin和消费者用户User同时在线。通过Sa-Token的多账号认证体系我们实现了商家后台采用严格会话控制30分钟不操作自动退出消费者端保持7天长效会话敏感操作如支付密码修改强制二次验证基于账号类型的精细化权限控制这套方案上线后权限相关的Bug减少了80%同时开发效率提升了40%。特别是在大促期间系统稳定支撑了10万用户并发登录验证了Sa-Token在高并发场景下的可靠性。
企业数字化 ERP 产品动态
相关推荐
ESP32连接OLED屏的完整指南与优化技巧 1. ESP32与OLED屏的基础连接刚拿到ESP32开发板和0.96寸OLED屏时,最让人头疼的就是接线问题。市面上常见的SSD1306 OLED屏主要分为I2C和SPI两种接口,我们这里以最普遍的4针I2C版本为例。实际接线时要注意:ESP32的默认I2C引脚是GPIO 21(SDA)和G… · 2026/11/19 8:47:04
C++ Windows开发中COLORREF与字符串转换的工业级实现 1. 项目概述:为什么我们需要处理COLORREF与字符串的转换?在Windows桌面应用开发,尤其是涉及图形界面、图像处理或者游戏开发的场景里,颜色是一个无处不在的元素。无论是设置一个按钮的背景色,还是绘制一幅复杂的图表&a… · 2026/11/6 17:32:05
【信息科学与工程学】【通信工程】第七十六篇 网络解决方案设计03 编号 类型 领域 子领域 问题 问题类型子问题 详细的数学分析(逐步推理的数学表达式) 参数列表及数值范围及边界条件 关联知识 加工工具及软硬件及机床装备及部署模式 N-995 网络适配 智算中心 DLB逐包逐流混合调度 如何配置DLB实现逐包和逐流混合调度,兼顾大流… · 2026/11/9 5:24:17
望城电工证快速办理避坑指南:郑州报考避坑指南来了 望城电工证快速办理避坑指南:郑州报考避坑指南来了 不知道去哪报名怕被中介坑?最近很多在郑州的电工想考证,发现市面上鱼龙混杂,很多中介打着“快速拿证”“包过”“免考试”等旗号,结果不是被坑钱就是拿不到证。今天就来聊聊【望城电工证快速办理】的那… · 2026/11/19 8:46:14
大连学电工证的学校值不值得考?外省证书能转吗?全解答来了 大连学电工证的学校值不值得考?外省证书能转吗?全解答来了 之前考的证在外省能不能转过来?这个问题是很多在外地打工的工友最关心的,尤其是像你这种已经在大连打工,但之前在别的省份考了电工证的人。其实, 大连学电工证的学校… · 2026/11/19 8:46:14
郑州报考避坑指南:从哪报考高级电工证全攻略 郑州报考避坑指南:从哪报考高级电工证全攻略 你还在为找不到高级电工证报考渠道发愁吗?急需特种作业证才能上岗找工作,现在就带你理清思路,避开郑州报考的那些坑,快速拿到证书。 一、高级电工证到底有啥用?为啥你非得考?… · 2026/11/19 8:46:14
电工证报名找不到培训怎么解决?上岗必备全攻略 电工证报名找不到培训怎么解决?上岗必备全攻略 怕考不过白交培训费?这事儿在电工证报考圈里太常见了,尤其现在网上信息混杂,很多学员一上来就被培训机构的套路“收割”,结果报名了找不到培训、学了又怕考试不过,钱花了还拿不到证。别慌,今天就从安阳培… · 2026/11/19 8:46:14
平凉市安监局电工证怎么考?网上查询复审流程全解析 平凉市安监局电工证怎么考?网上查询复审流程全解析 证书过期了不知道怎么复审延期?最近有不少平凉市的电工朋友跑来问,网上查来查去也找不到清晰的流程,耽误了工作和项目。其实,复审延期并不难,关键是方法要对。本文就带大家一步步了解平凉市安监局电工… · 2026/11/19 8:45:14
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/18 8:19:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/18 14:38:14
姑苏区哪里考电工证好考前押题怎么找 姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12
罗定能考电工证吗 电工证含金量到底有多少? 罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38